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Warranty 

SCION Corporation certifies that each computer system will be free from defective materials and workman- 
ship for ninety [90] days from date of shipment to the original customer. 

SCION Corporation agrees to correct any of the above defects when the system is returned to the factory 
prepaid. Written authorization must be obtained and confirmed in writing by the Customer Service Depart- 
ment before returning the equipment to the factory. 

Under this warranty, SCION Corporation will, at the request of the customer, provide the necessary com- 
ponents required by the customer to correct the equipment in the field. The components will be shipped, 
prepaid, on a billing memo which will be cancelled upon receipt of the defective components at the factory. 
When ordering components for repair or replacement, the model number and serial number must be includ- 
ed on the customer request. 

This warranty is invalid if the system is subject to mis-use, neglect, accident, improper installation or applica- 
tion, alteration or negligence in use, storage, transportation or handling and where the serial number has 
been removed, defaced or changed. 



FOREWORD April 1981 



This Spring marks the beginning of MicroAngelo's second year of wide acceptance across a broad range of 
applications. In this system we have attempted to bring a carefully designed and integrated hard- 
ware/firmware/software package to the marketplace in an affordable and powerful single board graphics 
computer. We are pleased to share our excitement in the design of MicroAngelo with you. 



Charles J. Rieger, III 
Vice President 
Research & Design 
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General Information 



The MicroAngelo^'^ Graphics System User's Manual 



1. General Information 

MicroAngelo™ is an intelligent high resolution refreshed raster scan graphics display system capable of 
drawing character and graphics images at high speed on a standard television monitor. Completely contained 
on a single iEEE-696 [SI 00] bus card, MicroAngelo is an independent ZBOA-based computer with its own 
32K byte display memory and 4K resident operating system, Screenware Pak I™, or optionally. Screenware 
Pak ir^ [BK]. By talking in concise high level commands over a simple inferface, your host computer directs 
MicroAngelo in generating graphics and text displays and in controlling the light pen interface. Because of its 
self-reliant architecture, MicroAngelo places no computing load or memory space demand on your com- 
puter. This means that, after giving directions to MicroAngelo, your- CPU can continue with its own com- 
puting as MicroAngelo concurrently carries out those directions using its own separate memory and CPU. 
The results are a more responsive and convenient graphics/text display system than ever before possible 
with traditional graphics board designs. 

1.1 Brief System Overview 

The MicroAngelo hardware resides on a single S1 00 bus board. This board contains all the electronics and 
software for generating a 51 2 dot wide. 480 dot high, black and white display for a high-resolution TV 
monitor [1 mhz bandwidth or better]. Since the board includes a ZBOA microprocessor, complete with its 
own RAM [32K bytes]. EPROM [up to BK bytes], and TV display circuitry, MicroAngelo is actually an in- 
dependent, single card computer which when inserted into your computer, appears to your system as two 
parallel ports. This architecture makes it possible for your computer to direct MicroAngelo via simple, 
powerful high-level graphics commands sent over the two parallel ports, then proceed with its own computa- 
tions while MicroAngelo carries out the display generation in parallel. Because of this simple and fast two- 
port interface. MicroAngelo is easy to integrate and does not require any of your system's valuable address 
space. 

The MicroAngelo software. Screenware Pak I or Screenware Pak II. has been designed so that the system 
can be used either as your main console output display, or as a separate graphics display processor, or both. 
Logically, the Screenware consists of two largely independent software subsystems called ALPHA and 
GRAPHICS. ALPHA emulates a "dumb terminal" interface, while GRAPHICS supports all the graphics 
primitives. To get on the air with MicroAngelo as your main output device, you need only implement the sim- 
ple interface to ALPHA shown below. 



1.2 Quick Integration Steps 

[Unless otherwise indicated, all memory addresses and operation codes throughout the manual 
are in hexidecimal notation.) 

To interface MicroAngelo to your computer as the main output device, do the following three things: 

1 . Decide whether or not the MicroAngel parallel ports, mapped from FO-FF, are compatible with 
your system. If your system currently uses any port in this range, you may have to alter the Port 
Address Jumpers to some other 1 6-port boundary. This procedure is described in the section en- 
titled "Changing the Port Addresses". 

2. Install the following interface code as your system's main ["console"] output routine. This code 
will send the byte in the A register to MicroAngelo's ALPHA component, and appear to your 
operating system to be a "dumb terminal" interface: 



ttyout 


push 


psw 


save the output byte 


tyol 


in 


0F1H 


read the Control Port 




ani 


1 


test buffer-full bit 




jnz 


tyOI 


wait until not full 




pop 


psw 


restore the output byte 




out 


OFOH 


send it to the Data Port 




ret 




return 



!f you have changed the port addressing as the result of Step 1 above, replace the references to 
output ports FO and F1 in this code to the appropriate new values. The software interface to 
MicroAngelo is described in more detail in the section entitled "Screenware Pak I and Screenware 
Pak II - The Onboard Software". 

3. Connect MicroAngelo to a TV monitor, as described in the section entitled "System Integration". 

At power-up time, MicroAngelo will clear the screen and display the winking text cursor in the upper left cor- 
ner of the screen. 

After getting on the air, you will then be able to take full advantage of the MicroAngelo graphics facilities, 
described in detail in later sections. 



1.3. Driving MicroAngelo from High Level Software 

If you will be driving MicroAngelo primarily from software written in a higher level language [e.g., BASIC, 
FORTRAN], you will find the interface very straightforward. Read the section entitled "The Software Inter- 
face", then refer to the sections 6.5 and 6.6 for examples. 



System Integration 



2. System integration 



The system is supplied fully assembled and tested, and is ready to insert into virtually any SI 00 bus com- 
puter after the port addresses have been set to be compatible with the host. [Micro Angelo can be easily 
adapted to non-Si 00 bus structures. See the section entitled "Adapting MicroAngelo to Non-Si 00 
Systems".] As shipped, the two MicroAngelo ports are mapped as FO and F1 in your system's port address 
space. Because of the way MicroAngelo interprets port addresses, however, the hardware will actually res- 
pond to 8 different ports within the group FO-FF, with port addresses FO. F4. FB, FC responding as one port 
and F1 , F5, F9, FD responding as the second port. Before inserting MicroAngelo into your system' 
therefore, verify that your system does not already currently use one of these 8 port addresses 



2.1 Changing the Port Addresees 



If the MicroAngelo default port addressing is not appropriate for your system, you may move to any other 
1 6 port boundary by altering the Port Address Jumpers J1 1 -J1 4, which are located near the bottom right 
comer of the board. As shipped, all four jumpers are set to logic "1 " by default printed circuit traces bet- 
ween the center and right hole. To switch a jumper to "0", scratch through the default trace and connect 
the center and left hole with a short length of wire. Set J1 1 -J1 4 according to the following table to obtain 
the desired port mapping: 



Desired Ports 



J14 



J13 



J12 



J11 



00-OF 
10-1F 
20-2F 
30-3F 
40-4F 
50-5F 
60-BF 
70-7F 
80-BF 
90-9F 
AO-AF 
BO-BF 
CO-CF 
DO-DF 
EO-EF 
FO-FF 
























1 








1 











1 


1 





1 











1 





1 





1 


1 








1 


1 


1 





















1 







1 










1 


1 




1 










1 





1 




1 


1 







1 


1 


1 



For example, to map the ports in the CO-CF group, cut through the default traces on J1 1 and J12. and 
solder in a short wire between the left and center holes on each of these two jumpers. 
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2.2 Connecting a TV Monitor 

The final video signals are available at connector JB at the extreme top left of the board. These pins are 
nunnbered 1-6 from left to right, and deliver the following signals: 

JB-1 RS-1 70 composite video 

JB-2 ground 

JB-3 direct-drive TTL video 

JB-4 ground 

JB-5 direct-drive, horizontal sync 

JB-6 direct-drive, vertical sync 

The system can drive either a composite video monitor or a direct-drive monitor, or both simultaneously. 
Connect a composite video monitor to JB-1 , JB-2. Connect a direct-drive monitor to JB-3. J&-4, JB-5, 
JB-6. 

After setting the port addresses and connecting the TV monitor, the MicroAngelo hardware will be fully 
operational in your host system, and you will then be able to install the simple software interface described in 
the next sections. The section entitled "System Details" describes other hardware options you may even- 
tually wish to use. 



2.3 The Software Interface 

All communications between your host computer and MicroAngelo occur over the two ports which have 
been situated at some 1 6 port boundary in your system. The lower-addressed port of this pair [e.g., FO] is 
the Data Port, the higher-addressed port [e.g., F1 ] is the Control Port. The Data Port is used for com- 
municating 8-bit data and command bytes to and from MicroAngelo, the Control Port for handshaking and 
for restarting MicroAngelo. The Screenware constantly monitors these two ports in anticipation of the next 
graphics command or data byte. 

When power is first applied to MicroAngelo, automatic restart circuitry initializes the system hardware 
and software. The screen is cleared, all cursors and software options described in sections below are set to 
their default values, and the Screenware begins listening over the Data Port for a command or data. 



2.3.1 Sending a Byte to MicroAngelo 

The Data Port is a latched, bi-directional pathway with handshaking. "Handshaking" means that before 
sending a byte, the sender must first verify that the previous byte has been processed by the receiver. 
Without handshaking the preceding data or command byte, which may not yet have been acted upon by the 
receiver, might inadvertently be overwritten by the sender's next byte. A latched, handshaking port is essen- 
tial when each side of the interface is an intelligent system running asynchronously with respect to the other. 
Handshaking applies symmetrically to both sides of the interface. 

Handshaking is accomplished with MicroAngelo as follows. The rightmost bit of the Control Port byte will 
be "1 " when there is a host command or data byte in the outbound Data Port which MicroAngelo has not yet 
acted upon. Thus, before sending any command or data byte over the Data Port, your system should always 
read the Control Port, test this "outbound buffer full" bit, and wait for it to become "0", if it is not already. 
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The following 8080 assembly language subroutine is the standard method of sending a data or command 
byte from the host's A register to MicroAngelo [without destroying any other registers]: 



dport 


equ 


OFOH 


cport 


equ 


0F1H 


sendbyte 


push 


psw 


sdb1 


in 


cport 




ani 


1 




jnz 


sbdl 




pop 


psw 




out 


dport 




ret 





declare the Data Port address 
declare the Control Port address 

save the byte a moment 
read the Control Port 
examine the status bit 
loop if buffer is full 
restore the byte to send 
send to the Data Port 
return 



[Note that this code is exactly what would be used if you were driving a dumb terminal.] See the section en- 
titled "Software Interface Examples" for an equivalent interface written in BASIC. 

In the opposite direction, when the Screenware sends the host system a response, an identical 
mechanism will cause the Screenware to wait for the host [i.e.. your software] to read the response from 
the Data Port before sending the next response byte. 



2.3.2. Reading a RaBponse from MicroAngelo 

The second from the right bit of the Control Port indicates to the host computer whether or not there is a 
response byte back from MicroAngelo waiting to be read from the inbound port. When "1 ", this bit indicates 
that a response byte is ready to be read over the Data Port; "0" means there is no 
byte to be read. When the host reads the byte from the Data Port, this bit is automatically reset to "0" to 
inform the Screenware that it is free to send the next response byte, if any. 

The following code is the standard method of reading a response from the Screenware. it waits for a 
response byte to enter the interface from the MicroAngelo side, then reads it and returns it in the host's A 
register [without altering any other registers]. 



readbyte 



in 


cport 


read the Control Port 


ani 


2 


isolate the "data available" bit 


Iz 


readbyte 


wait if no byte ready yet 


in 


dport 


read the byte from the Data Port 


ret 




return 



The SENDBYTE and READBYTE routines implement a complete MicroAngelo interface. In a typical CP/M- 
based system, these two subroutines should be coded and placed in the USER I/O area, where they can be 
called by high-level system and user software to control MicroAngelo. 



13 



2.3.3. Restarting MicroAngelo 

Your system can restart MicroAngelo at any time via the Control Port. By outputting a 01 byte [actually, 
any byte with the rightmost bit "1 "] to the Control Port, the host causes the hardware reset condition to 
begin on the MicroAngelo board. This reset will persist until a 00 byte is sent to the Control Port, and is func- 
tionally identical to the power-on reset generated by the MicroAngelo hardware at the time the system was 
first turned on. Immediately after the host releases the MicroAngelo from the reset, Screenware Pak I will 
clear the screen and reinitialize all modes and parameters to their default values. All current context will be 
lost. Screenware Pak II reacts somewhat differently, see Section 4.15 for details. 

Example code for restarting MicroAngelo is: 

graphrst mvi a,1 send a "1" to the Control Port 



return 



mvi 


a,1 


out 


cport 


mvi 


a,0 


out 


cport 


ret 





You may wish to include this code in your operating system's warm- and/or cold-start initialization code so 
that the MicroAngelo display will be restarted each time the host goes through its own initialization se- 
quence. On the other hand, the only condition under which you actually have to use the reset is when user 
software has sent an erroneous or incomplete command sequence to MicroAngelo, or when user-loaded 
code has lost control onboard MicroAngelo [see the UTILITY and USER commands]. 



2.3.4. Summary of the Control Port 

To summarize, the Control Port plays two roles. Reading this port delivers the interface handshaking bits: 



7 


6 


5 


4 


3 


2 


1 





XX 


XX 


XX 


XX 


XX 


XX 


IF 


OF 



IF: Inbound buffer [from MicroAngelo to host] is full 
OF: Outbound buffer(from host to MicroAngelo] is full 
XX: Unused 

Writing to this port controls the MicroAngelo hardware reset: 



7 


6 


5 


4 


3 


2 


1 





XX 


XX 


XX 


XX 


XX 


XX 


XX 


HR 



HR: "1 " causes the hardware reset to begin 

"0" releases the reset condition, allowing MicroAngelo to restart 



XX: Unused 
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Screenware Pak I and 

Screenware Pak II 
The Onboard Software 



3. Screenware Pak I and Screenware Pak II - the Onboard Software 

Screenware responds to commands and data sent over the Data Port under the conventions described in 
the previous section. Screenware can be thought of as tw/o largely independent components: ALPHA and 
GRAPHICS. The ALPHA [standing for "alpha-numeric"] component manages the graphics display as though 
it were a text-only "dumb terminal". This allows you to get on the air quickly, using MicroAngelo as your 
system's primary output device. The GRAPHICS component recognizes a variety of graphics commands for 
operations such as point, vector, region and special character generation, and light pen control. Because of 
the way the Screenware interprets commands and data, ALPHA and GRAPHICS are both always active, so 
that you are not forced to be in one mode or the other at each moment, as with some other types of 
graphics systems. 

Upon receiving a byte from the host over the Data Port, the Screenware first inspects the high-order bit 
of the byte. If this bit is "0": 



7 


6 


5 


4 3 2 


1 












ASCII CODE 







the byte is sent to the ALPHA processor. Since the ALPHA processor is emulating a dumb terminal, the 
byte will be interpreted as an ASCII character, and acted upon appropriately. If the code is a printing 
character, it is printed on the screen at the current ALPHA cursor, and the cursor is advanced, possibly in- 
voking the ALPHA scrolling mechanism. Alternatively, if it is an ASCII control character [e.g., carriage- 
return, backspace), then the ALPHA processor takes the appropriate control action. [The specific ASCII 
control codes to which ALPHA responds are described below.) Thus, the ALPHA component provides a com- 
plete dumb terminal emulation. 

If the high bit of a received byte is "1 ", the byte is interpreted as a command, with the next five high-order 
bits specifying the opcode. Except for opcode [which relates to the dumb terminal emulator], all commands 
are handled by the GRAPHICS component. 

The Screenware Pak I and Screenware Pak II commands are: 

7 B 5 4 3 2 1 



1 


OPCODE 


MODE 



code 


Command 




Name 


Pak 1 and Screenware 





ALPHAMODE 


1 


GCURSOR 


2 


SCREEN 


3 


POINT 


4 


VECTOR 


5 


REGION 


6 


CHARACTER 


7 


LIGHTPEN 


8 


CROSSHAIRS 


9 


MEMORY 


10 


UTILITY 


11 


USER 



Function 



select various ALPHA mode options 
set or read the graphics cursor 
clear the screen, set figure/ground 
turn on or read a point 
draw a vector [line] 
draw a rectangular region 
plot or define a graphics character 
turn on or off, or read the light pen 
control the graphics crosshairs 
dump, load screen or memory 
arm USER, call user code, arm RTl 
call user-defined function 
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19 


FLOOD 


20 


MACRO 


21-31 


RESERVED 



Screenware Pak II: 

1 2 TEST perform diagnostic EPROM. RAM, ALPHA, or Mun- 

ching Squares test 

1 3 RGRAPHC move the graphics cursor by a relative amount 

14 SPLITSCR split the screen, or load the default character 

generator or ASCII control code group 

1 5 RPOINT plot a point at relative displacement from current cur- 

sor 

1 6 RVECTOR draw a vector to endpoint specified by relative coor- 

dinates 

1 7 RREGION paint a region of extent specified by relative coor- 

dinates 

1 8 CIRCLE draw a circle of specified radius at the current 

graphics cursor 

flood a bordered region with all 1 "s or O's 
define, invoke, or delete a named graphics object 
reserved for future use 

The two rightmost bits of a GRAPHICS command byte are used in specifying a mode or subfunction within 
these 20 categories. The ALPHAMODE command is described below. 



3.1 ALPHA - The Dumb Terminal Emulator 

At startup time, the Screenware clears the display, displays a winking text cursor in the upper left corner 
of the screen, and begins emulating a "dumb terminal" capable of at least a 300 character per second data 
rate [3000 baud equivalent) under most conditions. Screenware Pak II enhances this rate to more than 
6000 baud. (The limiting factor for the data rata is the scrolling software. For applications requiring higher 
data rates, "rolling" instead of scrolling may work to your advantage. See the ALPHAMODE command.] 

Each ASCII code your system sends over the Data Port is treated by the dumb terminal emulator as either 
a printing ASCII character or an ASCII control code, and will cause the appropriate screen activity to occur 
automatically. 



3.1.1 Dumb Terminal Screen Conventions 

The ALPHA processor treats the screen as a text grid of 40 lines of 85 characters per line. Row is at 
the top, row 39 is at the bottom, column is at the left, column 84 is at the right. The ALPHA CURSOR, 
[AR, AC], always identifies the screen position to which the next ALPHA character will be written, and is in- 
itialized at restart time to [0, 0]. 

Characters on the screen are 1 2 pixels high, 6 pixels wide, and are generated by the Screenware from its 
internal character generator table. [Appendix 2 shows this character set in detail.] However, using the 
CHARACTER and/or MEMORY commands, you can define a second, alternate set of 1 28 characters. [See 
the section "Defining the Alternate Character Set" for a description of this procedure.] 
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3.1.2. Dumb Terminal ASCII Control Codes 

The ALPHA dumb terminal emulator recognizes and processes the following standard ASCII control 
codes: 

^^ [08] - Backspace [back up to and erase previous character] 

HT [09] - Horizontal Tab [moves to next B column boundary] 

LF [OA] - Line Feed [ignored] 

FF [OC] - Form Feed [clears the screen] 

OR [OD] - Carriage Return [also does a line feed] 

ESC [IB] - Escape [causes the next ALPHA byte to be printed literally] 

DEL [7F] - Delete [treated as BS] 

Screenware Pak II conditionally recognizes 

HOME [01 ] - Home alpha cursor 

DELEOL [OE] - Delete text to end-of-line 
DELEOP [OF] - Delete text to end-of-page 
CURUP [11] - Cursor up 

CURDN [12] - Cursor down 

CURLF [13] - Cursor left 

CURRT [14] - Cursor right 



3.1.3. Dumb Terminal Printing Options 

The dumb terminal emulator can be conditioned to print text in a number of special modes. If you do not 
need any of these modes, no action is required. However, the following modes are available and can be 
selected by calls to the ALPHAMODE command described in the section entitled "MicroAnqelo 
Commands": 

1 . Rgure/ground [whether to print white-on-black or black-on-white characters] 

2. Underlining [whether or not to underline characters as they are printed] 

3. Overstrike [whether to overstrike or print as usual] 

4. Font [whether to use the standard or user-defined font] 

5. Cursor [whether or not the winking cursor should be displayed] 

8. Scroll [how much to pop up when text would fall off the bottom of the screen] 
7. Coordinates [where to print the next text character] 

The defaults for these are: 

1 . Light Characters on dark background 

2. Underlining off 

3. Overstrike off 

4. Standard font 

5. Visible cursor 
6. 10-line pop-up 

7. Starting cursor coordinates at row 0, column 

See the ALPHAMODE command if you wish to change any of these defaults. 
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3.1.4. The Dumb Terminai Interface Code 

Because of the ALPHA component's ability to emulate a standard terminal, MicroAngelo will become your 
system's main output device after a simple integration step. To make MicroAngelo your main output device, 
install the following code in your system's Usei' area as the subroutine to be called to output the A register to 
the screen. In this code [wfiich is repeated from the section entitled "Quick Integration Steps"), DPORT and 
CPORT refer to the two communications ports described earlier. Unless you have changed the port mapp 
ing, these are FO and F1 , respectively. 



dport 


equ 


OFOH 


cport 


equ 


OFIH 


ttyout 


push 


psw 


tt01 


in 


cport 




ani 


1 




jnz 


ttOI 




pop 


psw 




out 


dport 




ret 





declare the Data Port 
declare the Control Port 

save the output character 

read the fVlicroAngelo Control Port 

test the output status bit 

loop if interface buffer still full 

send the character 

to the MicroAngelo Data Port 

return 



If you wish warm- and/or cold-starts of your system to restart MicroAngelo, also insert the following reset 
code in your host system's initialization sequence[s]: 



ttyrst 



mvi 


a,1 


send a hardware reset 


out 


cport 


to the Control Port 


mvi 


a.O 


release the reset condition 


out 


cport 




ret 




return 



3.2. GRAPHICS - The MicroAngelo Graphics System 

The GRAPHICS processor is responsible for plotting points, vectors, regions and characters of 
special size or orientation, and for controlling the light pen interface. GRAPHICS responds to various com- 
mands described in the section entitled "MicroAngelo Commands", and is largely independent of the ALPHA 
processor, which emulates a dumb, text-only terminal. The sections below describe the GRAPHICS conven- 
tions and cursors. 
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3.2.1. GRAPHICS Screen Conventions 

The Screen is a 51 2 wide by 480 high grid of on/off pixels ("picture elements"). X coordinates range from 
0-51 1 left to right, Y coordinates from 0-479 bottom to top. In the descriptions below, the term "graphics 
coordinates" refers to this coordinate system. Since a graphics coordinate requires 9 bits, two bytes are 
used when specifying a graphics coordinate to MicroAngelo. By convention, the high byte is always sent first, 
the low byte second. For example, to send the coordinate 293 decimal (1 25 hex], send a first byte of 01 
hex. a second byte of 25 hex. Any graphics X coordinate larger than 511 or Y coordinate larger than 479 
sent to Screenware will be clipped to its maximum value. 

A pixel is "on" when a "1 " bit is stored in its corresponding location in the MicroAngelo display memory. 
However, whether an "on" condition is seen as a light dot on a dark background or a dark dot on a light 
background is determined by the setting of the screen's figure/ground hardware, described in the SCREEN 
primitive below. 



3.2.2. GRAPHICS Cursors and Coordinates 

The Screenware continously maintains six cursor and coordinate pairs: 

[AR.AC] - the current row and column of the ALPHA CURSOR; AR ranges from 0-39 top 
to bottom, AC from to 84 left to right 

(AX, AY] - the graphics coordinates of the lower left pixel of the character at (AR,AC] 

(CX,CY] - the main GRAPHICS CURSOR'S coordinates 

(LX.LY] - the coordinates of the most recent light pen firing 

(TX.TY] - the graphics coordinates of the tracking cross 

(HX.HY] - the graphics coordinates of the crosshairs 

(AR.AC] and (AX, AY] are maintained by the ALPHA component. The others are described in the following 
sections, and are all initialized to (0,0] at restart time. 
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MicroAngelo 
ComiTiancIs 



4. MicroAngalo Commands 



This section describes the 12 Screenware Pak I and Pak II connmands, and 9 Screenware Pak II com- 
mands. In these descriptions the calling sequence is indicated by 

CALL: < hex opcode ) < byte > . . . < byte ) 

i.e., to use the command, send the hex opcode followed by the specified byte-sized parameters, all over the 
Data Port. MicroAngelo responses, if any, are indicated by 

RESPONSE: < byte > . , . < byte > 

If a command generates responses, your software must always read those responses. Otherwise, the 
Screenware will become backlogged and will eventually stop responding until any outstanding responses are 
read. 

The first command. ALPHAMODE. is used to set the various dumb terminal printing options, and relates 
more to the ALPHA component than to the GRAPHICS component. The remaining commands relate to 
MicroAngelo graphics. Appendix 1 summarizes all commands and gives decimal and octal equivalents for the 
opcodes. 
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4.1. ALPHAMODE 



OPCODE 



ALPHAMODE 



7 


B 


5 


4 


3 


2 


1 





1 

















M 


M 



MODE 0: SET ALPHA MODE BITS 
CALL: 80 < mode > 
RESPONSE: none 



The ALPHA MODE word is set to the < mode > byte. The format of the ALPHA MODE word is: 



sc 


EC 


HS 


CU 


FO 


OS 


UL 


FG 



SC 



■r 



EC 


■0" 
■V 


HS 


•0" 
■1" 


CU 


•0" 
■1" 


FO 


■Q" 
■1" 


OS 


■O" 
"1" 


UL 


■0" 
'1" 


FG 


'0" 
'V 



means do not clear screen or home [AR.AC] 
means clear screen and home [AR.AC] 

[SC is not actually stored as part of the ALPHA MODE word, but 
has only a one-time effect at command time.) 

[Pak 11 only] disables special ASCII code interpretation 
[Pak II only] enables special ASCII code interpretation 

[Pak II only] selects normal mode 
[Pak II only] selects high speed mode 

enables display of the winking cursor 
inhibits display of the cursor 

selects the standard Screenwsre Pak character set 
selects the character overstrike mode 

selects normal erase-before-print mode 
selects character overstrike mode 

inhibits underlining 
turns on underlining 

selects light characters on dark background 
selects dark characters on light background 
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Bits 20H and 40H of the ALPHA mode word have meaning in Pak II. Bit 20H of the ALPHA MODE word is 
now defined as the "high speed select" bit. When set to 1 , the new high speed ALPHA mode is selected, 
when set to the normal [although also somewhat improved] mode is selected, the poweron default is nor- 
mal mode. In high speed mode, only the innermost 8 scan lines of the character are generated, leaving the 
top and bottom 2 of all characters' 1 2 scan lines ungenerated. While this is adequate for all characters in 
the default character set, user-defined characters that make use of the top or bottom 2 lines will not be fully 
generated in high speed mode. Additionally, the high speed mode ignores the figure/ground, underline, and 
overstrike option bits. 

Bits 40H of the ALPHA mode word governs whether or not the special ASCII control codes for cursor and 
screen control will be enabled [see the SPLITSCR command]. When this bit is 1 , special codes will be pro- 
cessed, and will take precedence over any other interpretation of those 8 ASCII characters. When this bit is 
[the power on default], codes will not be recognized. 

MODE 1 : POSITION ALPHA CURSOR 
CALL: 81 < row > < col > 
RESPONSE: none 

The ALPHA CURSOR is set to [ < row > , < col > ]. This "escape sequence" allows for quick reposi- 
tioning of the cursor. Subsequent text will be printed starting at the new location. 

MODE 2: READ ALPHA CURSOR 

CALL: 82 

RESPONSE: < row > < col > 

The Current ALPHA CURSOR location is returned, row first then column. 

MODE 3: SET ALPHA SCROLL 
CALL: 83 < n > 
RESPONSE: none 

The ALPHA scroll parameter is set to < n > . If < n > =0, "roll mode" is selected. In this mode, 
rather than popping up, the cursor wraps around to the top line and clears one line at a time in ad- 
vance as it reuses the screen. This mode is fastest, since it requires no pop-up time, but can be 
somewhat visually confusing. If < n ) is greater than and less than 40, the screen will be popped 
up < n > lines each time text is about to fall off the bottom .If < n > is greater than 39. the entire 
screen will be cleared at pop-up time, and new text begun at the top. 



Notes 

The SPLITSCR command augments the ALPHAMODE command and provides two other services relating 
to the ALPHA facility. In particular, the ALPHA screen can now be restricted to a user defined number of 
bottom screen lines. When the screen has been split by this command, issuing the ALPHA screen clear 
command clears only this bottom region. Also, the scroll parameter applies to this bottom region, and is set 
by SPLITSCR. Refer to the SPLITSCR sections for details. 
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4.2. GCURSOn 



OPCODE 1 - GCURSOR 



7 


B 


5 


4 


3 


2 


1 





1 











G 


1 


M 


M 



MODE D: SET GRAPHICS CURSOR 
CALL: 84 < xh > < xl > < yh > < yl > 
RESPONSE: none 



The Graphics cursor [CX.CY] is set to the values specified. [ < xh > is the high byte of the CX coor- 
dinate, <xl> IS the low byte. <yh> is the high byte of the CY coordinate, <yl> the low byte.] The 
main graphics cursor is never actually visible, but serves as the relative origin of several graphics 
operations. [CX.CY] is automatically moved by several graphics operations. 

MODE 1 : READ GRAPHICS CURSOR 

CALL: 85 

RESPONSE: < xh > < xl > < yh > < yl > 

The current [CX.CY] coordinates are reported. 

MODE 2: SET [CX.CY] TO [AX.AY] 
CALL: 86 
RESPONSE: none 

CX is set to AX, CY is set to AY. This is useful for coordinating text and graphics. 

MODE 3: SET [CX.CY] TO [TX.TY] 
CALL: 87 
RESPONSE: none 

[CX.CY] are set to [TX.TY]. 
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4.3. SCREEN 

7 6 5 4 3 2 1 

OPCODE 2 - SCREEN ' ' ' 



10 



M M 



MODE 0: CLEAR SCREEN 
CALL: 88 
RESPONSE: none 



The display screen is cleared by turning all pixels "off". If the figure/ground has been set to light- 
on-dark, the screen goes completely dark. If the figure/ground has been set to dark-on-light the 
screen goes completely light. 



NOTES 



In Screenware Pak 11 the CLEAR SCREEN command applies only to the top region of the screen, in case 
the SPLITSCR command has been issued to divide the screen between top [graphics/text] and bottom [dumb 
terminal text only]. If the screen is not divided [i.e.. all 40 lines are allocated to the ALPHA screen] CLEAR 
SCREEN will clear the entire screen. Refer to the SPLITSCR command for details. Also, the tracking cross 
and crosshairs are momentarily removed [if on] during a clear so that they are not erroneously erased 



MODE 1 : SET SCREEN FIGURE/GROUND 
CALL: 89 < fg > 
RESPONSE: none 

The figure ground is set according to the rightmost bit of the following byte, < fg > . A "0" bit 
selects light-on-dark, a "1" bit selects dark-on-light. 

MODE 2: TOGGLE SCREEN FIGURE/GROUND 
CALL: 8A 
RESPONSE: none 

The current figure/ground is toggled. This is useful, for example, in rapid screen flashes to attract 
the user's attention. 

MODE 3: READ SCREEN FIGURE/GROUND 
CALL: 8B 
RESPONSE: < fg ) 

The current figure/ground status is returned as the rightmost bit of the response byte. 
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4.4 POINT 



OPCODE 3 - POINT 



7 


B 


5 


4 


3 


2 


1 





1 











1 


1 


M 


M 



MODE 0: TURN POINT OFF 

CALL: 8C < xh > < xl > ( yh > < yl > 

RESPONSE: none 

The point at the specified graphics coordinates is turned off. (CX. CY] are set to this location. 

MODE 1 : TURN POINT ON 

CALL: 8D < xh > < xl > < yh > < yl > 

RESPONSE: none 

The point at the specified graphics coordinates is turned on. [CX, CY] are set to this location. 

MODE 2: COMPLEMENT POINT 
CALL: BE < xh > < xl > < yh > < yl > 
RESPONSE: none 

The point at the specified graphics coordinates is complemented. [CX, CY] are set to this location. 

MODE 3: READ POINT 

CALL: 8F < xh ) < xl > < yh > < yl > 

RESPONSE: < val > 

A byte containing only the requested pixel is returned. If this byte is zero, the point is off; if non- 
zero, the point is on. [CX, CY] are set to this location. 
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4.5 VECTOR 



OPCODE 4 - VECTOR 







5 












1 

M 




M 



J 



MODE 0: TURN VECTOR OFF 
CALL: 90 < xh > < xl ) < yh ) < yl > 
RESPONSE: none 

All points lying along the vector between and including [CX, CY) and the coordinates specified in 
the command are turned off. [CX. CY] are set to the new endpoint after the operation. 

MODE 1 : TURN VECTOR ON 
CALL: 91 < xh > < xl ) < yh > < yl > 
RESPONSE: none 

All points lying along the vector between and including [CX, CY] and the coordinates specified in 
the command are turned on. [CX, CY] are set to the new endpoint after the operation. 

MODE 2: COMPLEMENT VECTOR 
CALL: 92 < xh ) < xl > < yh > < yl > 
RESPONSE: none 

All points lying along the vector between and including [CX, CY] and the coordinates specified in 
the command are complemented. [CX, CY] are set to the new endpoint after the operation. 

MODE 3: NO OPERATION 
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4.6 REGION 



OPCODE 5 - REGION 



7 


6 


5 


4 


3 


2 


1 





1 








1 





1 


M 


M 



MODE 0: TURN REGION OFF 

CALL: 94 < x1 h ) < x1 1 > < y1 h > < y1 1 > < x2h ) < x2l > < y2h > < y2l > 

RESPONSE: none 

All bits in the rectangular region identified by the diagonally opposing corner points given in the 
command are turned off. [CX. CY] are unaffected. 

MODE 1 : TURN REGION ON 

CALL: 95 <x1h> <x1l> <y1h> <y1l> < x2h > ( x2l > < y2h > < y2l > 

RESPONSE: none 

All bits in the rectangular region identified by the diagonally opposing corner points given in the 
command are turned on. [CX, CY] are unaffected. 

MODE 2: COMPLEMENT REGION 

CALL:g6<x1h> <x1l> <y1h> <y1l> < x2h > < x2l > < y2h > < v2l > 

RESPONSE: none 

All bits in the rectangular region identified by the diagonally opposing corner points given in the 
command are complemented. [CX. CY) are unaffected. 

MODE 3: NO OPERATION 
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4.7 CHARACTER 



OPCODE 6 - CHARACTER 



7 


6 


5 


4 


3 


2 



1 


1 








1 


1 


M 




M 



MODE 0: PLOT GRAPHICS CHARACTER 
CALL: 98 < c ) 
RESPONSE: none 

The character identified by the following byte, < c > , is plotted at [CX, CY], and [CX, CY] is ad- 
vanced to the position at which the next graphics character of similar type would be plotted. [CX, 
CY] defines where the lower left pixel of the character [with respect to the character's frame of 
reference] is to be plotted. The low-order 7 bits of < c > are the ASCII code of the desired 
character. The high-order bit identifies the font: "0" for standard, "1 " for user-defined. [These 
are the same fonts as used by ALPHA.] The plotting of the character is carried out according to 
the four mode bits in the GRAPHICS MODE WORD [see MODE 1 below]: 



XX 


XX 


XX 


XX 


FG 


SZ 


DD 


DD 



DD: These two bits determine the character's print direction 
and orientation, as follows: 



SZ: 



FG: 



left to right, character upright 
right to left, character upside-down 
bottom to top, character 90 degrees ccw 
top to bottom, character 90 degrees cw 



"0" selects normal size character [6 by 1 2] 
"1 " selects double size character [12 by 24] 

"0" selects light on dark figure/ground 
"1 " selects dark on light figure/ground 



For example, to write a double-size, dark on light message up the left edge of the screen 
[characters 90 degrees CCW], set the mode word to OE. Note that GRAPHICS characters plot- 
ted by this command have no relation to the ALPHA component, except that both rely on the 
same fonts. Because of the added complexity, the GRAPHICS mode character plotting takes 
somewhat longer than ALPHA mode. 
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MODE 1 : SET GRAPHICS CHARACTER MODE 
CALL: 99 < mode > 
RESPONSE: none 

The GRAPHICS MODE word is set to < mode > 
GRAPHICS characters. [See above]. 

MODE 2: DEFINE ALTERNATE CHARACTER 
CALL: 9A <asc> < si 1 > ... ( sO > 
RESPONSE: none 



The modes thus defined apply to all subsequent 



The 6 by 1 2 bit pattern for ASCII character code < asc > is defined and inserted into the user- 
defined font. The bit pattern is sent as 1 2 bytes < s11 > < sO > which represent 1 2 scan 

lines of the character, from top to bottom. Each < si > byte's low order 6 bits define the 8 pixels 
across that scan line of the character. For example, to define ASCII code 1 3 as a bold, full-height 
"T", you would call the Screenware as follows: 

9A 13 3F 3F OC DC DC OC OC GC OC DC OC DC 

When printed, this character would then appear on the screen as: 



To install a complete user font, the UTILITY primitive's block DEPOSIT mode is faster. The user- 
defined font is stored in MicroAngelo's memory beginning at address 0F940H. By depositing 
12*128 = 1536 continuous bytes starting at this address, you will effectively be loading the 
entire user-defined font in one command. 

MODE 3: LOAD DEFAULT CHARACTER SET [Screenware Pak II only] 
CALL: 9B 
RESPONSE: none 

The standard MicroAngelo character set in EPROM is copied to the user-defined font region. 
Note that this region may also be in use for other purposes [see the USER and MACRO com- 
mands], so that care should be taken in managing this storage. This command is useful when the 
user wishes the alternate character set to be largely similar to the default, except where changed 
via the DEHNE ALTERNATE CHARACTER command. 
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4.8 LIGHTPEN 







OPCODE 7 - LIGHTPEN 







M M 



The light pen interface [described electrically in the section entitled "Connecting a Lightpen"! provides a 
method of comnnunicating with host software by pointing rather than typing. When operating the light pen 
will generate pulses that are converted to coordinates by the Screenware. In Scneenware the light pen soft- 
ware IS always enabled, and is always ready to record the most recent light pen signal coordinates [LX LY] 
These coordinates are accurate to two pixels vertically and horizontally when a quality light pen is used fsee 
the section entitled "Connecting a Light Pen"]. > => t- i 

When the "tracking cross" is turned on (and visible as a small complemented cross on the screen] any 
hght pen activity within the vicinity of the cross is interpreted as a command to adjust the cross so that it is 
dead-centered under the light pen. With the Screenware continulusly [and at high speed] adjusting its loca- 
tion to remain under the light pen, the cross appears to follow the pen where ever the user moves it When 
the tracking cross is enabled, its coordinates are known as [TX, TY]. 

The following commands deal with the light pen interface. 

MODE 0: TURN TRACKING CROSS OFF 
CALL: 9C 
RESPONSE: none 

The light pen tracking cross is removed from the screen, if present. The system powers up with 
the cross off. ^ r m 

MODE 1 : TURN TRACKING CROSS ON 
CALL: 9D < xh > < xl ) < yh > < y| > 
RESPONSE: none 

If the tracking cross is on. it is turned off. The cross is then displayed at the specified coordinates 
and [TX, TY] are set to this position. 

MODE 2: READ TRACKING CROSS 
CALL: 9E 
RESPONSE: 00 

or 

01 < xh > < xl > < yh > < yl > 

The current tracking cross coordinates, [TX. TY], are returned. 
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MODE 3; READ LIGHT PEN 
CALL: 9F 
RESPDNSE: 00 

or 

01 < xh > ( xl ) < yh > ( yl > 

Regardless of whether or not the tracking cross is on, if the light pen has fired since the last 
reading via this command, a 01 byte, followed by the most recent light pen coordinates, is return- 
ed. A 00 response is returned if the light pen has not fired since the last reading. The light pen is 
logically reset to await another firing. This mode is useful, for example, in detecting when the user 
is pointing at a menu item on the screen. 



Notes 

In Screenware Pak II the tracking cross pen-following algorithm has been improved to provide a more 
stable cross display, and to provide better tracking response. Also, the tracking cross is now momentarily 
removed [if on] during either an ALPHA or GRAPHICS screen clear or ALPHA scroll to prevent its erroneous 
erasure or duplication 
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4.9 CROSSHAIRS 



2 1 



OPCODE 8 - CROSSHAIRS 



10 



M M 



The Screenware "crosshairs" are a full-screen vertical line and horizontal line which, when visible, in- 
tersect at the current crosshair coordinates [HX, HY]. Crosshairs are useful for indicating the coordinates 
of the next graphics operation in an interactive design environment. The crosshairs are independent of the 
main graphics cursor [ CX, CY] and the tracking cross and lightpen coordinates (TX, TY] and [LX, LY]. 
However, simple user software that constantly monitors these other coordinates can logically couple the 
crosshairs to any of them. 

MODE 0: TURN CROSSHAIRS OFF 
CALL: AO 
RESPONSE: none 

If the crosshairs are on, they are turned off. [HX, HY] remain as they are. 

MODE 1 : DRAW CROSSHAIRS 
CALL: A1 < xh > < xl ) < yh ) < yl ) 
RESPONSE: none 

If the crosshairs are on, they are turned off. The crosshairs are then turned on at the specified 
coordinates, and (HX, HY] are set to these coordinates. 

MODE 2: READ CROSSHAIRS 

CALL: A2 

RESPONSE: < xh > < xl > ( yh > < yl > 

The current crosshair coordinates, [HX, HY], are returned. 

MODE 3: DRAW CROSSHAIRS AT [CX, CY] 
CALL: A3 
RESPONSE: none 

If the crosshairs are on, they are turned off. [HX, HY] are set to [CX, CY] and the crosshairs are 
drawn at this new location. 

Notes 

In Screenware Pak II the crosshairs are now momentarily removed [if on] during ALPHA or GRAPHICS 
screen clears and for ALPHA scrolling to prevent their erroneous erasure or duplication. 
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4.10 MEMORY 




OPCODE 9 - MEMORY f iH 1 n T T M m 
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6 


5 
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1 








1 


M 



MODE 0: DUMP SCREEN 

CALL: A4 

RESPONSE: < b1 ) ... < b7G00 ) 



The 7a00H bytes of the display screen are reported, top screen scan line first, working left to 
right. This command is useful for storing screen images on disk. 

MODE 1 : LOAD SCREEN 
CALL: A5 < b1 > ... < b780G > 
RESPONSE: none 

The 7B00H bytes of the display screen are loaded, top screen scan line first, working left to right. 
This command will load a previously dumped screen image. 

MODE 2; EXAMINE MEMORY BLOCK 
CALL: A6 < nh ) < nl > < ah > < al > 
RESPONSE: < b1 > ... < bn > 

The N bytes [specified by < nh > ( nl > ] of MicroAngelo's memory starting at the address 
specified by < ah > < al > are reported. See the section entitled "The MicroAngelo Memory Map" 
for a description of how the system's memory space is allocated. 

MODE 3: DEPOSIT MEMORY BLOCK 

CALL: A7 < nh > < nl ) < ah > < al > < b1 > < bn ) 

RESPONSE: none 

The memory block of specified length and starting address is loaded, using the N bytes following 
the command. This command is useful for loading the alternate font, and for loading user graphics 
code to augment the Screenware. To load a complete user-defined font of 1 28 ASCII characters 
of 1 2 scan lines [bytes] each, say: 

A7 06 00 F9 40 

then write the BOOH font bytes to the Data Port. [See the section entitled "Defining the Alter- 
nate Character Set" for more details.] Before loading user code via this command, see the sec- 
tion entitled "The MicroAngelo Memory Map". 

Notes 

In Screenware Pak II memory deposits and screen loads run much faster because of a change in protocol 
Memory examines and screen dumps run slightly faster. 
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4.11 UTILITY 



OPCODE 1 - UTILITY 
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MODE 0: SET USER COMMAND ADDRESS 
CALL: A8 < ah > < al > 
RESPONSE: none 

The address of the code to be called by the USER command [opcode 11 ] is defined as < ah > ( al > . 
The code should have been deposited into MicroAngelo's RAM via a MEMORY command prior to 
this command. See the section entitled "The MicroAngelo Memory Map" before installing any 
user code. 



MODE 1 : CALL USER CODE 
CALL: A9 < ah > < al > ( imask > 
RESPONSE: none 



< iah > ( iai > 



The Screenw/are calls the user code at the specified address. The user code gains control of the 
MicroAngelo CPU, may alter all registers except the stack pointer, and can return by executing a 
RET instruction. If the stack pointer is altered, the Screenware should be reentered at location 0, 
[Pak I] or location 6gH [Pak II], i.e., restarted. 

As the user code is called, 3 types of logical interrupts can be enabled: DFHI [Data From Host], 
DTHI [Data To Host], and LPI [Ught Pen]. [See the section entitled "Interrupts" for a description 
of MicroAngelo interrupts.] < imask > identifies which [if any] interrupt sources to enable: 



7 


6 


5 


4 


3 


2 


1 





XX 


XX 


XX 


XX 


XX 


LP 


DT 


OF 



LP enable Light Pen interrupts 
DT enable Data To Host interrupts 
OF enable Data From Host interrupts 



When an enabled interrupt occurs, the user interrupt handling code at the address specified by < 
iah ) ( iaI > will be called under the following context: [1 ] interrupts will be disabled, [2] an EX AF, 
AF', EXX sequence will have been done to save all registers, [3] the A register will contain the in- 
terrupt mask [in the format shown above] defining the source[s] of the current interrupt. After 
finishing, the interrupt handling code should return via the sequence EX AF, AF', EXX, El, RET. 
This CALL command will permit you to install a completely independent operating system within 
MicroAngelo, and will give this operating system access to interrupts. 
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MODE 2; SWITCH REAL-TIME INTERRUPTS 
CALL: AA 00 

or 

AA 01 < ah > < al ) 
RESPONSE: none 



If the second byte of the command is 00. the 1/60 second real-time interval interrupts are disabl- 
ed. If the second byte is 01 , real-time interrupts are enabled, and will call the user-defined code at 
location ( ah > ( al > . This code should protect all registers on the stack [i.e. , not via an EX AF 
AF', EXX sequence], and should return via a RETI instruction, since the real-time clock interrupt is 
non-maskable. Before arming or using the real-time clock, read the section entitled "Interrupts" 



MODE 3: FORCE COLD START [Screenware Pak II only] 
CALL: AB 
RESPONSE: none 



A cold powerup sequence is forced, causing the MicroAngelo to be completely reset This com- 
mand IS necessary because Screenware Pak II distinguishes between the first and subsequent 
hardware resets by storing and reading a flag byte [a byte which would be extremely unlikely to ap- 
pear in RAM randomly at poweron]. 
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4.12 USER 



7 6 5 4 3 2 10 

OPCODE 1 1 - USER 



1 Q 



M M 



MODES 0,1 ,2,3: CALL USER PRIMITIVE 
CALLS: AC, AD, AE, AF 
RESPONSES: user-defined 

This command provides a simple interface wherein user-extensions to Screenware software can 
be called. Before using this command, first install the user code in MicroAngelo's RAM using the 
MEMORY command's DEPOSIT mode. Then declare the code's entry address via the UTILITY 
command's MODE 0. After this setup procedure, the four USER opcodes shown above will all be 
routed to this user code. At call time, the two mode bits [i.e., the bits that distinguish the four 
USER command opcodes) are available to the user code as the two rightmost bits of the B 
register [ail other bits zero]. The user code is permitted to alter any registers except the stack 
pointer, and should return to the Screenware via a RET instruction. Before using this feature, 
read the section entitled "The MicroAngelo Memory Map". 

Notes 

The USER command will usually consume memory which is also used by the CHARACTER commands [per- 
taining to the user-defined alternate character set]. Since the MACRO facility [Screenware Pak II only] will 
also require some of this memory, additional care in allocating this space should be exercised. Refer to the 
MACRO command for details. 
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4.13 TEST (Screenware Pak II only] 



OPCODE 1 9 - TEST 
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MODE 0: TEST EPROM 
CALL: BO < blocks ) 
RESPONSE: ( cksum ) 

( n ) 1 024 byte blocks, starting at address 0. of the EPROM are checksummed, and the result 
returned as (cksum ) , computed by summing all bytes in the block, modulo 256. This command 
provides a means of verifying that the EPROMs are functioning correctly. Specify 6 blocks to test 
all of Screenware Pak II. The checksum for each EPROM is noted on the EPROM's label. When 
testing more than one EPROM [i.e., testing 4 or 6 blocks], add the individual EPROMs' 
checksums [in hexidecimal] to compare with the TEST EPROM's returned < cksum > 

MODE 1 : TEST RAM 
CALL: B1 
RESPONSE: or 

1 < ah ) < ai > < eb ) < fb ) 

The entire 32K MicroAngelo RAM is tested by writing a cyclic test pattern, which ensures that 
every possible byte value has been successfully stored and read in every memory location. The 
test requires several minutes, and is visible as patterns of changing vertical bands on the screen. 
If the test discovers no faults, a response is returned and a cold poweron sequence executed to 
reset the system. If a fault is discovered, a 1 followed by the faulty address high and low bytes, ex- 
pected data byte, and faulty data byte, respectively, are returned. The Screenware then disables 
interrupts, and enters a halt loop, under the assumption that useful computations are no longer 
possible. 

MODE 2: ALPHA TEST 
CALL: 82 
RESPONSE: none 

The entire default character set is repetitively printed to the ALPHA screen, exercizing the 
figure/ground and underline options in various combinations. All ALPHA modes are left unaffected 
by the test. 

MODE 3: MUNCHING SQUARES 
CALL: 83 < s > < i ) ( n ) 
RESPONSE: none 

Visually interesting, changing geometric patterns are generated by the Munching Squares 
algorithm. The seed ( s '> and increment < i > are any 8 bit values, and determine the pattern 
that will be repetitively generated. < n > , any 6 bit value, determines how many cycles the display 
will run through before terminating and clearing the screen [ < n > =0 causes 64 cycles]. Each < 
n > unit corresponds to about 45 seconds of real time. Try some of these values of [ < s ) , < i ) ] 
for starters: [1.1], [5,19], [2,2], [7,3]. 
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4.14 RGRAPHC (Screenware Pak II only] 



OPCODE 13 -RGRAPHC 
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MODE 0: SET RELATIVE GRAPHICS CURSOR 
CALL: B4 ( dxh > ; dxl ) ( dyh > ( dyl > 
RESPONSE: none 

The graphics cursor is moved by an offset specified by the four calling bytes. 2's complement 
arithmetic is used for negative offsets. As with the GRAPHIC command, RGRAPHC clips if 
necessary to keep the graphics cursor in bounds. 

MODE 1 : NO OPERATION 
MODE 2: NO OPERATION 
MODE 3: NO OPERATION 



43 



4.15 SPLITSCR [Screenware Pak M only) 



7 


6 


5 


4 


3 


2 


1 





1 





1 


1 


1 





M 


M 



OPCODE 1 4 - SPLITSCR 

MODE 0: SET ALPHA SCREEN SIZE 
CALL: BB < I ) 
RESPONSE: none 

The screen is logically split between a top graphics/text region and bottom text/scrolling region. ( 
I ) specifies the number of text lines to be allocated as the bottom region, and is clipped to the 
range 1-40 if not already in that range. Screenware Pak II powers on with an < I > value of 40 
[i.e., the entire screen is available to the ALPHA processor, as in Screenware Pak I]. Note that 
splitting the screen does not restrict graphics to the top region, but rather only restricts the 
ALPHA facility to the bottom region. Two side effects of this command are that the ALPHA cur- 
sor is homed, and that the ALPHA scroll parameter [the number of lines to pop up when the 
ALPHA region of the screen is full] is set to one-quarter the new ALPHA region height [or I 
minimum). However, the user is free to redefine the scroll parameter after a SPLITSCR. 
SPLITSCR may be called at any time to redefine the size of the ALPHA area. 

MODE 1 : DEFINE ALPHA CONTROL CODES 
CALL: B9 (c1 > ... < c8 ) 
RESPONSE: none 

The ALPHA [dumb terminal] processor can now be instructed to recognize eight special ASCII 
control codes: 



01 H 



HOME 



OEH 



OFH 



DELEOL 



DELEOP 



the ALPHA cursor is homed to the top left of the ALPHA 
region 

text at and beyond the current ALPHA cursor is deleted to 

the end of the line 

text at and beyond the current ALPHA cursor is deleted to 

the end of the page [ALPHA region] 

the ALPHA cursor is moved up one line if possible 

the ALPHA cursor is moved down one line if possible 

the ALPHA cursor is moved left one character if possible 

the ALPHA cursor is moved right one character if possible 

the ALPHA region is cleared [form feed], and the cursor is 
homed 

To maintain Screenware Pak I compatibility, the ALPHA processor will interpret these special 
codes only when the 4aH bit of the ALPHA mode word is set [refer to the ALPHAMODE com- 
mand]. If the default codes are not acceptable, the user may redefine them via this command. All 
codes must be in the range O-IFH [i.e.. in the ASCII control code region]. While this command re- 
quires that all eight codes be specified, it will leave unchanged any code whose new value is not in 
this range, allowing for selective alteration of the codes. < cl > ... < cB > correspond in order to 
the eight functions listed above. In addition to defining the special codes, this command enables 
their interpretation by the ALPHA processor [by setting the 40H bit of the ALPHAMODE word]. 



11H 


CURUP 


12H 


CURDN 


13H 


CURLF 


14H 


CURRT 


OCH 


FF 



MODE 2: NO OPERATION 
MODE 3: NO OPERATION 
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4.16 RPOINT [Screenware Pak II only] 



OPCODE 1 9 - RPOINT 
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MODE 0: TURN RELATIVE POINT OFF 
CALL: BC ( dxh > ( dxl ) < dyh > ( dyl ) 
RESPONSE: none 

MODE 1 : TURN RELATIVE POINT ON 
CALL: BD < dxh > < dxl > ( dyh > < dyl) 
RESPONSE: none 

MODE 2: COMPLEMENT RELATIVE POINT 
CALL: BE < dxh > ( dxl > < dyh ) < dyl > 
RESPONSE: none 

MODE 3: READ RELATIVE POINT 
CALL: BF ( dxh > < dxl ) < dyh > < dyl > 
RESPONSE: < val J 

These comnnands are identical to the POINT commands, except that they interpret their 
parameters as the X and Y relative offset from the current graphics cursor, rather than absolute 
screen coordinates. As with the POINT commands, the graphics cursor is updated to the new ab- 
solute screen location resulting from the relative offset. 
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4.17 RVECTOR (Screenuiare Pak II only) 



OPCODE 1 6 - RVECTOR 
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MODE 0: TURN RELATIVE VECTOR OFF 
CALL: CO < dxh > < dxl > < dyh > ( dyl > 
RESPONSE: none 

MODE 1 : TURN REUVTIVE VECTOR ON 
CALL: CI < dxh > ( dxl > ( dyh ) < dyl > 
RESPONSE: none 

MODE 2: COMPLEMENT RELATIVE VECTOR 
CALL: C2 < dxh > < dxl ) < dyh ) < dyl ) 
RESPONSE: none 

MODE 3: NO OPERATION 

These commands are identical to the VECTOR commands, except that they interpret their 
parameters as the X and Y relative offset from the current graphics cursor, rather than absolute 
screen coordinates. As with the VECTOR commands, the graphics cursor is updated to the new 
absolute screen location resulting from the relative offset. 
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4.18 RREGION (Screenware Pak II only] 



OPCODE 1 7 - RREGION 
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MODE 0: TURN RELATIVE REGION OFF 

CALL: C4 < dxl h > < dxl I > ( dyl h > < dyll ) < dx2h > < dx2l > < dy2h > < dy2l ) 

RESPONSE: none 

MODE 1 : TURN RELATIVE REGION ON 

CALL: 05 < dxl h > < dxll > < dy1 h > < dy1l ) < dx2h > < dx2l > < dy2h > < dy2l > 

RESPONSE: none 

MODE 2: COMPLEMENT RELATIVE REGION 

CALL: C6 < dx1 h > (dxll) <dy1h> < dyll > < dx2h > < dx2l > < dy2h > < dy2l ) 

RESPONSE: none 

MODE 3: NO OPERATION 

These commands are identical to the region commands, except that they interpret their 
parameters as the X and Y relative offset from the current graphics cursor, rather than absolute 
screen coordinates. Typically, to paint a region situated with one corner at the current graphics 
cursor, RREGION is called with coordinates 0,0,DX,DY, where DX and DY are the size of the 
desired region. As with the region commands, the graphics cursor is not moved. 
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4.19 CIRCLE [Screenware Pak il only] 



OPCODE 1 8 - CIRCLE 
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MODE 0: TURN CIRCLE OFF 
CALL: CB < r > 
RESPONSE: none 



Points on the circle of radius < r > centered at the current graphics cursor are turned off. ( r > 
may be any single byte value. Points on the circle out of range in the Y dimension are clipped. 
Points out of range in the X dimension are wrapped around to the opposite side of the screen. 

MODE 1 : TURN CIRCLE ON 
CALL: C9 ( r > 
RESPONSE: none 

Points on the circle of radius < r ) centered at the current graphics cursor are turned on. Other- 
wise, this mode is identical to Mode 0. 

MODE 2: COMPLEMENT CIRCLE 
CALL: CA < r > 
RESPONSE: none 

Points on the circle of radius < r > centered at the current graphics cursor are complemented. 
Otherwise, this mode is identical to Mode G. 

MODE 3: NO OPERATION 
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4.20 FLOOD [Screenware Pak II only] 



OPCODE 1 9 - FLOOD 
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MODE 0: FLOOD WITH ZEROES 
CALL: CC < xh > < xl > < yh ) < yl > 
RESPONSE: none 

The bordered region containing the interior point specified by the arguments is flooded with 
zeroes. The region must be completely bordered by zeroes, and its interior must be completely fill- 
ed with ones for the algorithm to work properly. The region may be any shape, and the starting in- 
terior point may be arbitrarily chosen. The flood algorithm is capable in principle of filling virtually 
any region. In practice, however, the algorithm is limited by stack space, and may not be able to fill 
an unusually complex region. Generally speaking, the amount of stack storage will relate to the 
degree of concavity detail in the border. Regions too complex for the 1 6-level stack will be rare, 
but can be flooded in pieces if necessary. Additionally, certain narrow 45 degree corridors [i.e., 
"necks" of complex regions which have a single bit wide, stair-step type of interior] pose logical 
problems, and cannot be filled because of potential confusion with the region's exterior. Since the 
flood algorithm checks screen limits, it can also be used to fill the exterior of an object, even 
though there are no borders at the screen edges. 

MODE 1 : FLOOD WITH ONES 
CALL: CD < xh ) < xl > < yh ) < yl ) 
RESPONSE: none 

The region containing the specified interior point is flooded with ones. The region must be com- 
pletely bordered by ones, and its interior must be completely zeroes. Otherwise, this mode is 
identical to Mode 0. 

MODE 2: FLOOD RELATIVE WITH ZEROES 
CALL: CE < dxh ) < dxl ) < dyh > < dyl > 
RESPONSE: none 

This command is identical to Mode 0, except that the starting interior point is specified as a 
relative offset from the current graphics cursor. 

MODE 3: FILL RELATIVE WITH ONES 
CALL: CF < dxh > < dxl > < dyh > < dyl > 
RESPONSE: none 

This command is identical to Mode 1 , except that the starting interior point is specified as a 
relative offset from the current graphics cursor. 
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4.21 MACRO (Scraenware Pak II only) 
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OPCODE 20 - MACRO 

The macro facility provides for the definition and automatic display of commonly used objects. It is useful 
both in streamlining the display of such objects, and in higher speed movement of screen objects than would 
otherwise be possible. Tfie macro storage space can be up to 1 536 [decimal] bytes long. Up to 255 distinct 
macros can be defined in this region, each individual macro being up to 256 bytes long. A macro is any se- 
quence of commands, exactly as they would be sent normally, and is defined by declaring its number [from G 
to 254], then sending the bytes which represent the sequence of MicroAngelo commands to become its 
"body". Macros are executed by the INVOKE MACRO command described below. The ERASE MACRO 
command can erase a macro and return its number to the available pool. 

The macro facility will issue responses to the Mode 0', 1 , and 2 commands below [no response for Mode 
3]. A response is either 0, to indicate success, or a number from 1 to 6 indicating that a failure occurred and 
its nature: 

RESPONSE MEANING 

SUCCESSFUL TRANSACTION 

1 DEFINITION ALREADY IN PROGRESS 

2 MACRO ALREADY EXISTS 

3 MACRO FACILITY SPACE EXHAUSTED 

4 NO DEFINITION IN PROGRESS 

5 MACRO IS TOO LONG [OVER 256 BYTES] 

6 MACRO DOES NOT EXIST 

Response bytes must always be read for proper MicroAngelo protocol to proceed. 

Because of limited MicroAngelo RAM, the macro processor uses the memory which is also allocated as 
the user-defined character font, and/or USER code area.- While the user can arrange to use all three 
features simultaneously, care must be taken to manage this 1 536 byte area properly. Each macro occupies 
2 bytes plus the number of bytes in its body. Each ASCII character in the user-defined character generator 
area occupies 1 2 bytes. Thus, by arranging never to use the first N alternate character codes, the user can 
have a macro storage area of 1 2*N bytes at the beginning of the 1 536 byte area. To assist in the manage- 
ment of this shared memory, the size of the macro definition area can be restricted via the ERASE MACRO 
command. 

MODE 0: START/STOP MACRO DEFINITION 
CALL: DO < n > 

or 

DOFF 
RESPONSE: (code) 

If < n > is any value but OFFH, this command begins the definition of the macro whose reference 
number will be ( n ) . The new definition will not be begun if there is another definition in progress, 
if < n > is already in use as a macro number, or if macro space has been exhausted. The response 
code indicating success or one of these failures should always be read by the user code, since 
otherwise the MicroAngelo to host communication port will remain blocked. After having opened 
the definition, the ADD NEXT MACRO BYTE command is used repetitively to build the macro 
body. Having built the body, the user instructs the macro facility to end the definition and "install" 
the macro by calling the START/STOP MACRO DEFINITION command a second time, but with < n 
> = OFFH. At that time, the macro becomes usable by the INVOKE MACRO command. 
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MODE 1 : ADD NEXT MACRO BYTE 
CALL: 01 < byte > 
RESPONSE: < code > 



< byte > is added to the body of the macro under current definition. A failure code will be returned 
if there is no definition in progress, if macro space is exhausted or if the macro has become too 
long. In case of failure, the current definition is closed and partially built macro discarded. The user 
should always read the response < code ) . 



MODE 2: ERASE MACRO OR CLEAR FACILITY 
CALL; 02 < n > 

or 

02 FF < sh > < si > 
RESPONSE: < code > 



In the first case, if < n > is the number of a defined macro, that macro is deleted from the macro 
space, and its storage number returned for reuse. If the named macro does not exist, the ap- 
propriate error code is returned. In the second case, when < n > = OFFH, the command is inter- 
preted as a macro facility reset directive. In this case, ail macros are erased, the number of bytes 
of the 1 536 shared memory region to be allocated to the macro facility is specified by < sh > , (si 
> , which should be in the range 0-1536. After this command, any attempt to build macros 
beyond this limit will return a failure code. The macro facility powers up in a reset condition, with all 
1 536 bytes allowed for macro definitions. Both forms of this command return a condition < code 
> , which should always be read by the user. 

MODE 3: INVOKE MACRO 
CALL: 03 < n > 
RESPONSE: none 

The macro whose number is < n > is invoked, i.e. , its body is fed to the command interpreter just 
as if it were coming straight from the user. If there is no macro number < n > , A NO OPERATION 
results. While the macro's invocation itself may cause a reponse to be generated, the INVOKE 
MACRO command itself never returns a success or failure response. When the invoked macro's 
body has been completely read. Screenware Pak II reverts to its normal command loop. However, 
since there are cases where it may be convenient for one macro to invoke other macros Screen- 
ware Pak II allows a macro invocation nesting depth of 8. Nestings beyond this depth are ignored. 
When a nested macro completes, control is resumed in the previous [calling] macro, and so forth 
until the normal command processor is again active. Naturally, care should be exercised in defin- 
ing macros, since, if a macro's body is incorrect, it may throw Screenware Pak II and the user out 
of logical touch with each other, just as would happen in any improperly formed direct command 
sequence. 

Macros will typically rely heavily on the new relative cursor, point, vector, and region commands and on 
the new circle and flood commands. Generally, the strategy for writing a macro is to work from the 'current 
cursor, and ensure that the cursor is left either where it was originally, or at some meaningful place for the 
next macro [if there will be a sequence of them, or. if they have been nested] to pick up. For macros that are 
capable of moving objects at relatively high speed on the screen, use only the complement mode of all draw- 
ing commands, so that the first invocation of the macro will draw, the second erase. 



.R1 



The following example illustrates how to set up. then use a macro. Suppose the goal is to define a macro' 
that will draw a triangle with lower left vertex at the current graphics cursor, flood the triangle's interior with 
1 's, draw a circle of O's inside the triangle, flood the circle's interior with D's, then leave the graphics cursor 
at the lower left vertex of the triangle where it began. The sequence of commands that are to form the 
macro's body is therefore: 



RVECTOR 

RVECTOR 

RVECTOR 

RFLOODO 

RGRAPHC 

CIRCLEZ 

RFLOODZ 

RGRAPHC 



+ 25 
+ 25 
-50 

+ 1 
+ 25 

15 



-25 



+ 50 

-50 



+ 1 

+ 25 


-25 



draw first side of triangle 

draw second side 

draw third 

flood triangle interior with ones 

move to triangle center point 

draw circle with zeroes 

flood circle interior with zeroes 

return cursor to starting point 



Hence, the sequence which defines this sequence as, say, macro is: 



00 00 

D1 CI D1 00 01 19 D1 00 D1 32 

01 CI D1 00 01 19 01 FF 01 CE 
01 CI 01 FF 01 CE 01 00 D1 00 
01 CF 01 DO 01 01 01 00 D1 01 
01 B4 01 00 01 19 01 00 01 19 
01 C8 01 OA 

01 CE 01 00 01 00 01 00 D1 00 
01 B4 01 FF 
00 FF 



01 E7 01 FF 01 E7 



start macro definition 
send first vector command 
send second vector command 
send third vector command 
send triangle flood command 
send rel cursor move command 
send circle command 
send circle flood command 
send rel cursor move command 
terminate and install macro 



This macro can then be invoked by calls of the form: 
D3 00 invoke macro number at current graphics cursor 



52 



System Details 



5. System Details 



MicroAngelo can be effectively used without a knowledge of the information in this section. However, if you 
wish to install a lightpen, read the subsection entitled "Connecting a Light Pen". If you plan on augmenting 
Screenware Pak I or Screenware Pak II with additional software, read this entire section. 



5.1 The MicroAngelo Memory Map 



Unless you plan on sending user code across to MicroAngelo via the MEMORY command, you need not be 
concerned with the internal memory map of a Screenware Pak. However, in order to install and interface 
user-defined graphics code, it is important to understand how a Screenware Pak uses the MicroAngelo 
memory space. 

REGION USE 

0000-OFFF Screenware Pak I in EPROM 

0000-1 7FF Screenware Pak II in EPROM 

1 000-7FFF Unimplemented [SW PK I] 

1 800-7FFF Unimplemented [SW PK II] 

BOOO-FFFF Read-write memory, subdivided as follows: 

B000-F7FF Visible display 

F800-F8BF 2 and one-half visible scan lines [which should be kept blanked] 

FBC0-F93F Screenware system stack 

F94G-FF3F User-defined character generator, or user code area 

FF40-FFFF Screenware working RAM 

If the alternate character set is defined and used, there is no space for user code. If, however, the alter- 
nate character set is not used [or if only a portion is used], the region F940-FF3F [1 .5K bytes] can be used in 
whole or in part for user code. 

User code should not make any unusual alterations to the system stack, nor should it alter any location in 
the FF40-FFFF region. 
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5.2 Defining the Alternate Character Set 

The alternate character set resides in the F940-FF3F region of MicroAngelo's RAM. Each character sym- 
bol occupies 1 2 bytes, top scan line first. Thus, the region F940-F94B holds the symbol for ASCII code 0, 
with the top scan line at F940, the bottom line at F94B. Within each byte, the low-order six bits define the 
pixels across a scan line of the character. The CHARACTER and ALPHAMODE commands allow you to 
select this alternate character set, or toggle between the alternate and standard sets. 

The alternate character set can be defined all at once by the Pak II command LOAD DEFAULT 
CHARACTER SET [Section 4.7], or by depositing [via the MEMORY command] all 1 28*1 2 bytes starting at 
location F940. [If not all 1 28 symbols need to be defined, you need not send the entire set, and can use any 
remaining space for user code.] Alternatively, symbols for individual ASCII codes can be defined using the 
CHARACTER command's Mode 2. 

As an example, suppose you wish initially to define alternate symbols for ASCII codes 0-63 [the lower half 
of the character set]. To do this, you say: 

A7 deposit 64*1 2 bytes at Fg40 

03 64*12 = 300 [hex] 

00 

F9 location F940 

40 send the 768 [decimal] bytes 

Suppose then at a later time you wish to alter the symbol for ASCII code 7. Then you say: 

9A define individual symbol via CHARACTER 

07 ASCII code 7 

send the twelve bytes, top scan line first 



5.3 Interfacing Onboard User Code to The Screenware 

User code installed in the MicroAngelo RAM will probably need to interact with the Screenware software 
primitives. Appendix 3, "Screenware Pak I User Entry Points" and Appendix 4, "Screenware Pak II Entry 
Points" gives entry point addresses and calling conventions for the various user-callable Screenware Pak I 
and Pak II functions. 
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5.4 The MicroAngelo Physical I/O Ports 



When running your own software in the MicroAngelo memory, you may occasionally wish to bypass the 
Screenware software and interact directly with the MicroAngelo hardware. When interacting directly with the 
hardware, user code has access to the following information as Z80A I/O ports 0-3: 



PORT MODE 

Input 
Output 

1 Input 



Output 

Input 

Output 
Input 

Output 



FUNCTION 

Data Port, from host 

Data Port, to host 

Status Bits: 

[rightmost bit] host-to-MicroAngelo data buffer is full 

1 Micro Angelo-to-host data buffer is full 

2 Light Pen strobe has fired 

3 Screen Rgure/Ground status 
4-7 Unused 

The rightmost bit sets the screen figure/ground ["0" for light on dark, "1 " for 
dark on light]. All other bits are unused. 

Light Pen horizontal counter latch [left of screen is count 0. right of screen is 
count 255]. accurate to 2 pixels 

Unused 

Light Pen vertical counter latch [top of screen is count 0, bottom of screen is 
count 239], accurate to 2 scan lines. Reading this port also resets the light pen 
interface, allowing it to trigger on the next light pen strobe. [See the section en- 
titled "Connecting a Light Pen" for more discussion.] 

Unused 



5.5 Interrupts 

There are four potential interrupt sources for the MicroAngelo's ZSOA: 

DFHI [Data From Host] - the host has just written a byte to the MicroAngelo Data Port 

DTHI [Data To Host] - the host has just read a byte from the Data Port 

LPI [Light Pen] - the light pen has just fired 

RTI [Real-Time] - the 60 hz interval timer has just fired 

The first three interrupt sources are connectable as maskable ZSOA interrupts. The Real-Time Interrupt, 
when enabled by a hardware jumper, will generate a Z80 NMI [non-maskable interrupt] every 1 /60 second! 
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5.5.1 Enabling/Disabling the Maskable Interrupts 

As shipped, only the LP! and DFHI are physically enabled. The DTHI has been disabled by rennoving U59 pin 
9 fronn its socket. Reinsert this pin to enable the DTHI. [Doing so will not logically interfere with the Screen- 
ware's logical operation. However, it will slow the software down somewhat when sending responses back to 
the host.] 

To disable the DFHI, remove U59 pin 1 from its socket. To disable the LPI, remove U59 pin 1 3 from its 
socket. [Do not disable these, however, unless you are installing a completely new operating system in 
EPROM! The Screenware assumes that these two interrupts are enabled, and will not run properly with 
them disabled.] See the UTILITY command [Mode 1 ] for a description of the logical user interface to these 
three maskable interrupts. 



5.5.2 Enabling the Real-Time Interrupt 

The RTI non-maskable interrupt can be enabled by scratching through the default trace between holes 2 
and 3 of J3, and jumpering holes 1 and 2 together. After this procedure, a non-maskable interrupt will be 
generated every 1 /60 second. See the UTILITY command [Mode 2] for a description of the logical user inter- 
face to this non-maskable interrupt. 

It should be noted that with the RTI connected, there is a very remote possibility that MicroAngelo will not 
power up correctly. Immediately after beginning, the Screenware software stores a specific code in one byte 
of its read-write memory to remind itself that RTI interrupts are logically disabled. If, however, an RTI occurs 
in the several microseconds between powering on and storing this disabling code, and if the MicroAngelo 
memory randomly happens to power up with this special code already present in the RTI enabling byte [very 
unlikely], then the Screenware will erroneously branch to what it thinks is the user-defined RTI handling code. 
This, of course, would cause the system to lose control. To be absolutely certain that MicroAngelo has 
powered up correctly with the RTI enabled, use the MEMORY command to examine the RTI logical status 
byte at location FFC5 immediately after system power-on [i.e., put this in your cold-start initialization code]. 
If this byte is not OCCH, keep resetting MicroAngelo [over the Control Port] until it is. Then reset the 
system one final time. [The chance of a bad power-up because of these circumstances is quite remote. You 
can therefore get along without these procedures for all but the most critical applications.] 



5.5.3 Connecting Host-Side Interrupts 

Jumper J5 on the MicroAngelo board can be set so that the host will be interrupted whenever 
MicroAngelo reads or writes a byte over the Data Port. J5 Pin 5 goes to logic "0" when MicroAngelo writes 
a byte to the host. J5 Pin 1 goes to logic "0" when MicroAngelo reads a byte from the host [i.e., when the 
host can write another byte to MicroAngelo]. J 5 Pins B, 1, 7, 2, 8, 3, 9, 4 connect to the SI 00 bus vec- 
tored interrupt lines [SI 00 fingers 4-1 1 , respectively]. By jumpering J5 Pin 5 and/or J5 Pin 1 to these 
vectored interrupt lines, you can route these two interrupt signals to the host CPU, if it is equipped to pro- 
cess them. Doing so permits the host operating system software to support an interrupt-driven protocol 
with MicroAngelo. 
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5.6 Connecting a Light Pen 

Connector J A at the top right corner of the board is the Light Pen Connector. Pinl accepts the rising edge 
triggered Light Pen Strobe, Pin 2 is the Light Pen Ground connection, Pin 3 accepts the active high Light Pen 
Enable, and Pin 4 is a regulated + 5 volt, 1 GO ma power source for the light pen. When Pin 3 is a logic "1" 
and a positive edge occurs on Pin 1 , the light pen hardware latch captures the display counters to record the 
X-Y location of the light pen. Further positive edges at Pin 1 will not be honored until the Screenware soft- 
ware [or user software] reads the counter value fronn the light pen hardware latch. As shipped, both Pin 1 
and Pin 3 are pulled down to logic "0" [by resistors R18, R19, respectively] in the absence of a light pen. 

If you wish to connect a light pen that generates both the strobe and enable signals, simply connect all 4 pins 
as described. [If your light pen is of the low-power type, you may have to remove R1 8 and R1 9, since these pull- 
down resistors may present an excessive current drain to the light pen.] If your light pen has no enable line, 
jumper Pin 3 and Pin 4 together to enable the light pen permanently. 

See the LIGHTPEN command and the section entitled "Interrupts" for descriptions of the logical light pen 
interface and light pen interrupts. 



5.7 Summary of Hardware Jumper Options and Connectors 

There are 1 5 jumpers and 3 connectors on the MicroAngelo board. The tables and diagram below sum- 
marize and describe these. For most applications there will be no need to alter any jumpers. Default settings 
are indicated with asterisks. 
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5.7.1. Hardware Jumpers 

NAME PINS FUNCTION 

J1 1-2* Select 480 visible scan lines 

2-3 Select 448 visible scan lines 

[Note that all Screenware software assumes that there are 480 visible 
lines. If you select the 448 option, you must assume responsibility for 
managing the display screen.] 

J2 1-2* Select 4 mhz Z80A operation 

2-3 Select 5 mhz ZBOA operation 

A ZBOA can usually run at 5 mhz. If you want to increase the speed of the 
system, select this option. 

J3 1 -2 Enable 60 hz Real-Time Interrupt [RTI] 

2-3* Disable 60 hz RTI 

See section entitled "Interrupts" 

J4 Holes 6,1,7, 2. 8. 3, 9. 4 connect to S1 00 bus fingers 4. 5, 6, 7. 8. 9. 

10, 1 1 respectively. [These are the vectored interrupt lines.] The signal 
at hole 5 is the inverted DTHI interrupt, the signal at hole 1 is the true 
DFHI signal [see the section entitled "Interrupts"]. By connecting DTHI- 
inverted and/or DFHI-true to vectored interrupt lines, you can arrange 
for your host system to be interrupted whenever MicroAngelo reads the 
byte last sent from the host, or sends a byte to the host. [See the sec- 
tion entitled "Interrupts".] The board is shipped with neither interrupt 
source connected. 

J6-J10 [These jumpers will allow future EPROM upgrade to an 8K operating 

system] 

J11-J14 1-2 Select port address bit = "0" 

2-3* Select address bit = "1" 

These four jumpers map the two parallel ports over which you com- 
municate with MicroAngelo. See the section entitled "Changing the Port 
Addresses". 

J1 5 1-2* Enable DFHI and DTHI interrupts 

2-3 Disable DFHI and DTHI interrupts 

This jumper can cause the MicroAngelo Z80A to be interrupted by com- 
munications activities with the host, as described in the section entitled 
"Interrupts" 
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5.7.2. Hardware Connectors 



NAME PIN FUNCTION 



JA 1 Light Pen Strobe. A positive-going signal on this pin causes the Screen- 

ware software to update [LX, LY), the light pen coordinates 

2 Light Pen Ground 

3 Light Pen Enable. A logic "1 " on this pin physically enables the Light Pen 
Strobe. It is typically fed by the activation switch in the light pen. 

4 -H 5 volt, 1 00 ma power source for light pen 

JB 1 Composite Video. Connect a composite video TV monitor to this pin and 

Pin 2. 

2 Composite Video Ground 

3 TTL Video. Connect a direct-drive video monitor to this and Pins 4, 5, 6 

4 Direct-Drive Ground 

5 Direct-Drive Horizontal Sync 

6 Direct-Drive Vertical Sync 

JC 1 -20 [Reserved for color interface] 
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5.8 Adapting MicroAngelo to Non-S100 Bus Systems 

Interfacing MicroAngelo to non-Si 00 bus systems is relatively straightforward because of its simple 
parallel port connection to the host system. Specifically, MicroAngelo requires the following SI 00 bus con- 
nections: 



SI 00 PIN 


NAME 


FUNCTION 


1,51 
50,100 


+ 8 
GND 


Unregulated + 8 volt power (2 amps] 
Ground 


2 

52 

90 


+ 18 
-18 
D07 


Unregulated + 1 8 volt power [1 amp] 
Unregulated - 1 8 volt power [1 00 ma 
Outbound data line 7 


40 


D06 


Outbound data line 6 


39 


005 


Outbound data line 5 


38 


004 


Outbound data line 4 


89 


003 


Outbound data line 3 


88 


002 


Outbound data line 2 


35 


001 


Outbound data line 1 


36 


000 


Outbound data line 


43 


017 


Inbound data line 7 


93 


016 


Inbound data line 6 


92 


015 


Inbound data line 5 


91 


014 


Inbound data line 4 


42 


013 


Inbound data line 3 


41 


012 


Inbound data line 2 


94 


on 


Inbound data line 1 


95 


010 


Inbound data line 


83 


A7 


Address line 7 


82 


A6 


Address line 6 


29 


A5 


Address line 5 


30 


A4 


Address line 4 


80 


A1 


Address line 1 


79 


AO 


Address line 


46 
45 
78 
77 


SINP 
SOUT 
POBIN 
PWR-BAR 


Input request 
Output request 
Input strobe 
Output strobe 



The data input and output lines can be tied together to form one 8 line bidirectional data bus. Commands 
and data are written to MicroAngelo on the coincidence of SOUT = "1 ", PWR-BAR = "0" and Board 
Select. Responses and status flags are read from MicroAngelo on the coincidence of SINP = "1 ", POBIN 
= "1 " and Board Select. Board Select occurs when address lines A7-A4 match the settings of jumpers 
J1 4-J1 1 and A1 = "0". On a read or write operation, address line AO determines whether the Oata Port 
or Control Port is selected. 
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For a stand-alone environment in which MicroAngelo will be powered by its own power supply and will be 
unrelated to its host's address space, a simple bidirectional parallel port interface can be implemented as 
follows: 

1 . Tie the data inbound and outbound lines together and route them to the host as the 8 bit 
bidirectional parallel I/O port. 

2. Tie A7, A6, A5, A4 permanently high (to match the default jumpers J14-J11], and tie A1 
permanently low. 

3. Tie PDBIN permanently high, PWR-BAR permanently low. 

4. Route AO to the host as the Data/Control Port select line [i.e. , MicroAngelo looks like 2 logical 
I/O ports over one physical I/O port connection]. 

5. Route SINP and SOUT to the host as the input and output command lines. 

Using this 1 2 conductor logical interface to the host (8 data lines, AO, SINP, SOUT, ground], MicroAngelo 
becomes a stand-alone graphics computer compatible with virtually any type of host system. By connecting 
the interrupt lines as described in the section entitled "Interrupts" and routing them to the host, the inter- 
face can also support a full interrupt protocol. 



5.9 Bit Mapping of Display RAM to Video Screen 



The address space of the MicroAngelo from locations 8000 to 0F7FF is RAM memory that is displayed on 
the video screen. Each of the 245, 670 bits within this range appears as a single picture element [pixel] on 
the screen. These bits are mapped onto the screen in a predefined way by the MicroAngelo hardware. The 
top leftmost point on the display is the most significant bit of the byte stored at location 8000. The point im- 
mediately to its right is the 2nd most significant bit of the byte at 8000. This continues for all the bits in byte 
8000 and then proceeds on across the screen with the bits from byte 8001 , then 8002, 8003, etc. for a 
total of 64 bytes. The second display row then begins with the most significant bit from the byte at location 
8040. The bottom rightmost bit of the display is the least significant bit of the byte at location 0F7FF. The 
MEMORY commands "examine" and "deposit" can be used for experimenting with the direct modification 
of the video display. 
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Software Interface 
Examples 



6. Software Interface Examples 



Send and receive all bytes in these examples using the code shown in the section entitled "The Software In- 
terface". 



6.1. Graphics: Clear Screen, Draw Triangle, Embed in Region 



88 clear the screen 

84 set the graphics cursor to [1 28, 1 28] decimal 

00 

80 

00 

80 

91 draw vector to [256,384] 

01 

00 

01 

80 

91 draw a vector to [384, 1 28] 

01 

80 

00 

80 

91 draw a vector to [1 28, 1 28] 

00 

80 

00 

80 

96 embed triangle in region by complementing 

00 make the region corners [64,64] and [448 448] 

40 

00 

40 

01 

CO 

01 

CO 



6.2. Turn On and Read the Tracking Cross 



9D turn the tracking cross on at screen center 

01 X = 256 

00 

00 Y = 242 

F2 

[wait for user to drag it to destination, then type a key on the host 
keyboard] 
9E read the location 

[The Screenware will send the coordinates as four response bytes 
which you then read.] 
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6.3. Write a Message Around the Border of a Square 

This code writes the characters "MicroAngelo!" in a box shape [i.e., "Mic" is on the top, "roA" is on the 
right side going down, "nge" is upside-down from right to left on the bottom, and "lo! " is on the left side go- 
ing up. Characters are double size and reversed figure/ground. 

84 move the graphics cursor to the screen center 

01 

00 

00 

99 set graphics character mode for top characters 

OC reversed figure/ground, double size 

98 print "M" 

4D 

98 print "i" 

69 

98 print "c" 
63 

99 select new orientation 

OF 90 degrees cw, top to bottom 

98 print "r" 

72 

98 print "o" 

BF 

98 print "A" 
41 

99 select new orientation 
00 upside-down, right to left 
98 print "n" 

BE 

98 print "g" 

67 

98 print "e" 
65 

99 select new orientation 

OE 90 degrees ccw, bottom to top 

98 print "I" 

BC 

98 print "o" 

BF 

98 print"!" 

21 
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6.4. Underlining in Dumb Terminal Mode 



The following code prints the message "Hello there" by switching into and out of ALPHA Underline Mode 
for a moment. 



48 
65 
6C 
6C 
6F 
20 
80 
02 
74 
68 
65 
72 
65 
80 
00 



print "H" 

print "e" 

print "I" 

print "I" 

print "o" 

print space 

give ALPHAMODE command to start underlining 

second-from-right bit governs underlining 

print "t" 

print "h" 

print "e" 

print "r" 

print "e" 

turn off underlining 
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6.5. Sample BASIC Interface 



Most high level graphics software is best developed in a higher level language. To illustrate how to drive 
MicroAngelo from North Star BASIC, four functions, FNO, FNI. FNS and FNR are shown below FNO will 
wait for the Control Port to indicate a read-to-send condition, then send a single given byte to MicroAngelo 
FNI will await a single byte MicroAngelo response, then return it as the functional value FNS will send a 1 6 
bit quantity (e.g., a coordinate or address], high order byte first, by two calls on FNO FNR will assemble a 
1 6 bit [two byte] response from MicroAngelo and return the 1 6 bit quantity as its functional value In these 
examples it is assumed that the Control Port is F1 and the Data Port is FO [241 240 decimal 
respectively]. If you have changed the port addresses, substitute these with the appropriate port number' 



1 01 00 REM SEND A BYTE TO MICROANGELO 

1 0200 DEF FNO[X] 

10300 I = INP[241] 

1 0400 IF I ( > 2*INT[I/2]THEN 1 0300 

1 0500 OUT 240, X 

10600 RETURN 

10700 FNEND 



10800 
10900 
11000 
11100 
11200 
11300 
11400 



REM READ A BYTE FROM MICROANGELO 

REM [CALL WITH A DUMMY PARAMETER] 

DEF FNI[X] 

I = INT[INP[241]/2] 

IF! = 2*iNT[l/2] 

RETURN INP[240] 

FNEND 



11500 
11 BOO 
11700 
11800 
11900 
12000 



REM SEND A 1 6 BIT QUANTITY TO MICROANGELO 

DEF FNS[X] 

I = FNO [INT[X/256]] 

I = FN0[X-256*INT[X/25B]] 

RETURN 

FNEND 



12100 
12200 
12300 
12400 
12500 
12600 



REM READ A 1 6 BIT QUANTITY FROM MICROANGELO 

REM [CALL WITH A DUMMY PARAMETER] 

DEF FNR[X] 

Q = FNI[0] 

RETURN 256*Q + FNI[0] 

FNEND 
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6.6 interfacing to FORTRAN 



The following subroutines are five examples of FORTRAN routines to direct MicroAngelo. 

C 

C 

C * * * output a byte to MicroAngelo 

C 

subroutine nnaout [ibyte] 
10 if [inp[241]. and.1] goto 10 

call out [240, ibyte] 

return 

end 

C 

C 

C * * * move graphics cursor to ex, cy 



subroutine cursor [ex, cy] 

call maout [84H] 

call coord [ex, cy] 

return 

end 

C 

C 

C * * * plot a point at ex, cy 

C 

subroutine point [ex, cy] 

call maout [8DH] 

call coord [ex, cy] 

return 

end 

C 

C 

C *** draw a vector to ex, cy 

C 

subroutine vector [ex, cy] 

call maout [91 H] 

call coord [ex, cy] 

return 

end 

C 
C 
C * * * output a 1 6 bit X and a 1 6 bit Y coordinate to MicroAngelo 



C 



subroutine coord [ex, cy] 

ic = cx/256.0 

call maout [ic] 

ie = int [cx-ie*255.9] 

call maout [ie] 

ic = cy/256.0 

call maout [ic] 

ie = int[ey-ic*255.9] 

call maout [ic] 

return 

end 
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Appendices 



Appendix 1 - Summary of Screenware Commands 



HEX DEC OCT 

ALPHAMODE 

BO 1 28 200 

81 129 201 

82 1 30 202 

83 131 203 

GCURSOR 

84 1 32 204 

85 1 33 205 

86 1 34 20B 

87 135 207 

SCREEN 

88 136 210 

89 137 211 
8A 138 212 
88 139 213 

POINT 

80 140 214 

80 141 215 

BE 142 216 

8F 143 217 

VECTOR 

90 144 220 

91 145 221 

92 146 



CALURESPONSE 



0: ( mode ) 

R:none 

C: (row) (col) 

R: none 

C: none 

R: ( row ) < col ) 

0: (n) 

R: none 



C: (xh) (xl> (yh) < yl) 

R: none 

C: none 

R: <xh> (xl> <yh> ( yl ) 

C: none 

R: none 

C: none 

R: none 



C: none 
R: none 
C: (fg) 
R: none 
C: none 
R: none 
C: none 
R: (fg) 



C: (xh) (xl) (yh) ( yl ) 

R: none 

C: <xh) (xl) <yh) ( yl) 

R: none 

C: ( xh ) ( xl ) ( yh ) ( yl ) 

R: none 

0: (xh) (xl) (yh) ( yl ) 

R: <val) 



C: ( xh ) ( xl ) ( yh ) ( yl ) 

R: none 

C: < xh ) ( xl ) ( yh ) ( yl ) 

R: none 

C: ( xh ) ( xl ) ( yh ) ( yl ) 

R: none 



FUNCTION 

Set Alpha Mode Bits 
Position Alpha Cursor 
Read Alpha Cursor 
Set Alpha Scroll 

Set Graphics Cursor 
Read Graphics Cursor 
Set [CX, CY] to [AX. AY] 
Set [CX. CY] to [TX, TY] 

Clear Screen 

Set Screen Rgure/Ground 
Toggle Screen Figure/Ground 
Read Screen Rgure/Ground 

Turn Point Off 
Turn Point On 
Complement Point 
Read Point 

Turn Vector Off 
Turn Vector On 
Complement Vector 
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REGION 

94 1 48 224 

95 149 225 

96 150 226 

CHARACTER 

98 152 230 

99 153 231 
gA 154 232 
98 155 233 

LIGHTPEN 

9C 1 56 234 

9D 157 235 

9E 158 236 

9F 159 237 

CROSSHAIRS 

AO 1 60 240 

A1 161 241 

A2 162 242 

A3 1 63 243 

MEMORY 

A4 1 64 244 

A5 1 65 245 

A6 1 66 246 

A7 1 67 247 



0: <x1h> 
<y1l> 
<y2h> 

R: none 

0: <x1h) 
<y1l> 
<y2h> 

R: none 

C: <x1h> 
(yll) 
<y2h> 

R: none 



<x1l> <y1h> 
<x2h> <x2l> 
<y2l> 

<x1l> <y1h> 
<x2h) <x2l> 
<y2l> 

<x1l> (y1h> 
(x2h> <x2l> 
(y2l> 



C: <c> 

R: none 

C: < mode > 

R: none 

C; (asc> <s11 > ... < sO ) 

R: none 

C: none 

R: none 



C: none 

R: none 

C: <xh> (xl) <yh> < yl ) 

R: none 

C: none 

R: <xh> <xl> (yh> < yl > 

C: none 

R: 00 or 

01 (xh> <xl> <yh) <yl) 



C: none 

R: none 

C: ( xh > < xl > ( yh > < yl) 

R: none 

C: none 

R: <xh) (xl> (yh> ( yl) 

C: none 

R: none 



C: none 

R: <b1 > ... <b7800> 

C: <b1 > ... <b7800> 

R: none 

C: <nh> <nl> (ah) < al > 

R: (b1 > ... <bn> 

C: < nh > < nl > < ah > < al ) 

(b1 > ... (bn> 
R: none 



Turn Region Off 



Turn Region On 



Complement Region 



Plot Graphics Character 
Set Graphics Character Mode 
Define Alternate Character 
Load Default Character Set 

Turn Tracking Cross Off 
Turn Tracking Cross On 
Read Tracking Cross 
Read Light Pen 



Turn Crosshairs Off 

Draw Crosshairs 

Read Crosshairs 

Draw Crosshairs at [CX. CY] 

Dump Screen 
Load Screen 
Examine Memory Block 
Deposit Memory Block 
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UTILITY 
AB 168 

A9 169 



AA 170 252 

AB 171 253 

USER 

AC 172 

AD 173 

AE 174 

AF 175 

TEST 

80 176 

B1 177 



B2 
83 



178 
179 



RGRAPHC 
B4 ISO 

SPLITSCR 

88 184 

89 185 

RPOINT 
BC 188 

BD 189 

BE 190 

8F 191 



250 C: <ah) < al ) 
R: none 

251 C: <ah> < al ) < imask ) 

<ih> (11 > 
R: none 
C: AA 00 or 

AA01 <ah) <al> 
R: none 
C: none 
R: none 



254 C: [user defined] 
R: [user defined] 

255 C: [user defined] 
R: [user defined] 

256 C: [user defined] 
R: [user defined] 

257 C: [user defined] 
R: [user defined) 



260 C: (blocks) 
R: ( cksum > 

261 C: none 
R: or 

1 (ah) (al) (eb) ( fb ) 

262 C: none 
R: none 

263 C: (s) (i) (n) 
R: none 



264 C: (dxh) ( dxl) 
(dyh) (dyl) 
R: none 



270 C: (I) 
R: none 

271 C: (c1 > ... (c8) 
R: none 



274 



275 



276 



277 



C: (dxh) 

(dyh) 
R: none 
C: (dxh) 

(dyh) 
R: none 
C: (dxh) 

(dyh) 
R: none 
C: (dxh) 

(dyh) 
R: (val) 



(dxl) 
(dyl) 

(dxl) 
(dyl) 

(dxl) 
(dyl) 

(dxl) 
(dyl) 



Set User Comnnand Address 
Call User Code 

Switch Real-Time Interrupts 

Force Cold Start 

User 
User 
User 
User 

Test EPROM 
Test RAM 

ALPHA Test 
Munching Squares 

Set Relative Graphics Cursor 



Set ALPHA Screen Size 
Define ALPHA Control Codes 

Turn Relative Point Off 
Turn Relative Point On 
Complement Relative Point 
Read Relative Point 



RVECTOR 



CO 



CI 



C2 



192 300 



193 301 



1 94 30E 



RREGION 
04 19B 



C5 197 305 



06 1 98 306 



CIRCLE 
08 200 

C9 201 

CA 202 

FLOOD 
CO 204 

CD 205 

CE 206 



MACRO 
DO 208 

D1 209 

D2 210 

D3 211 



310 



311 



312 



314 



315 



316 



OF 207 317 



320 



321 



322 



323 



C: (dxh> (dxl> 

< dyh > < dyl > 

R: none 

C: <dxh> <dxl> 

<dyh> <dyl> 

R: none 

C: <dxh> <dxl> 

<dyh> <dyl> 

R: none 



304 C: <dx1h> <dx1l> 
<dy1h> <dy1l> 
<dx2h> <dx2l> 
<dy2h> <dy2l> 

R: none 

C: <dx1h> <dx1l> 
<dy1h> <dy1l> 
<dx2h> <dx2l> 
<dy2h> <dy2l> 

R: none 

C: <dx1h> <dx1l> 
<dy1h> <dy1l> 
< dx2h > < dx2l > 
<dy2h> <dy2l> 

R: none 



C: <r> 
R: none 
C: <r> 
R: none 
C: <r> 
R: none 



C: < xh > < xl > < yh > 
R: none 

C: < xh > < xl > < yh > 
R: none 



<yl> 
<yl) 



C: <dxh> 
<dyh> 

R: none 

C: <dxh> 
<dyh> 

R: none 



<dxl> 
<dyl> 

<dxl> 
<dyl> 



C: < n > or 

FF 
R; < code ) 
C: < byte > 
R: < code ) 
C: < n > or 

FF < sh > 
R: < code ) 
C: <n> 



Turn Relative Vector Off 
Turn Relative Vector On 
Complement Relative Vector 



Turn Relative Region Off 



Turn Relative Region On 



Complement Relative Region 



(sl> 



Turn Circle Off 
Turn Circle On 
Complement Circle 

Rood w/ith Zeroes 

Rood with Ones 

Rood Relative with Zeroes 

Flood Relative with Ones 

Start/Stop Macro Definition 

Add Next Macro Byte 
Erase Macro or Clear Facility 

Invoke Macro 
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Appendix 2 

The Standard Character Font 
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IB 
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* * 
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* * 

* * 
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Appendix 3 

Screenware^*^ Pak I Internal Entry Points 



SYSTEM 

entry: 

exit: 

destroys: 

description: 



READBUF 



entry: 
exit: 



destroys: 
description: 



GETBYTE 

entry: 

exit: 

destroys: 

description: 

GETCOORD 

entry: 

exit: 

destroys: 

description: 

GETYCORD 

entry: 

exit: 

destroys: 

description: 



GETADDR 

entry: 

exit; 

destroys: 

description: 

SENDBYTE 

entry: 

exit: 

destroys: 

description: 



SENDCOORD 

entry: 

exit: 

destroys: 

description: 



OOOOH 

none 

none 

NA 

cell here to restart the system as it would be at cold start 

012FH 

none 

carry flag set if a byte is available, cleared otherwise; if carry set, [A] = byte from 

host 

A, D. E, H, L 

call here to read a byte from the host [via the interrupt buffered interface] if a 

byte is available 

01A4H 

none 

[A] = byte from host 

none 

call here to read a byte from the host; GETBYTE waits until a byte is available 

005BH 

none 

[HL] = coordinate from host [sent high byte first] 

H, L 

call here to read a 9-bit coordinate from the host; the high 7 bits of H are zeroed 

0197H 

none 

[HL] = 9-bit coordinate clipped to 479 

A 

call here to read a 9-bit coordinate from the host; the coordinate is clipped to 479 

if it is larger 

03BFH 

none 

[HL] = 1 6-bit address from host [sent high byte first] 

A 

call here to get a 1 6-bit quantity from the host 

0259H 

[A] = byte 

none 

B 

call here to send a byte to the host; SENDBYTE waits until the outbound buffer is 

clear before sending 

0254H 

[HL] = 1 6-bit value to send to host 

none 

B 

call here to send 1 B bits [high order byte first] to the host 
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DPYLOC 



entry: 
exit: 



destroys: 
description: 



SCREENC 

entry: 

exit: 

destroys: 

description: 



POINT 



entry: 



exit: 

destroys: 

description: 



VECTOR 



entry: 



exit: 

destroys: 

description: 



021 BH 

[DE] = X coordinate [0-511] 

[HL] = Y coordinate [0-479] 

[A] = bit mask 

[B] = bit nnask 

[C] = bit number [0 leftmost, 7 rightmost] 
[HL] = display buffer address 

D. E 

call here to convert coordinates into a ZOO memory address [on the visible screen] 
and bit mask; the bit mask [containing one ON bit) identifies the pixel within the ad- 
dress byte; the bit number is the position of the ON bit within the byte 

01AFH 

[A] = mode [0. 1 . 2,] 
none 

all 

call here for SCREEN command, as described in the manual; do not call with mode 

= 3, since this mode will try to read a byte from the host 

01F7H 

[B] = mode [0, 1 , 2] 
[DE] = X coordinate 
[HL] = Y coordinate 
[CX] = X coordinate 
[CY] = Y coordinate 
none 

all 

call here for POINT command, as described in the manual; do not call with mode 

= 3, since the code will then send a response to the host 

0547H 

[B] = mode 

[OE] = x coordinate 

[NEWCX] = x coordinate 

[HL] = y coordinate 

[NEWCY] = y coordinate 

none 

all 

call here for the VECTOR commands, as described in the manual 



REGION 0275H 

entry: enter via the following code sequence: 

LXI H, RETURN 

PUSHH 

MVI B. < mode > 

PUSHB 

LXI H, < Yl > 

PUSH H 

LXI H. < X2 > 

PUSHH 

LXI D, < XI > 

LXI H, < Y2 > 

JMP REGION 

RETURN: ... 
exit: none 
destroys: all 
description: call via the given sequence for the REGION commands, as described in the manual 
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CHAR 



entry: 

exit: 

destroys: 

desGt'iption: 



DRAWCROSS 

entry: 

exit: 

destroys: 

description: 

DRAWHAIRS 

entry: 

exit: 

destroys: 

description: 



ALPHINIT 

entry: 

exit: 

destroys: 

description: 



TTYCHAR 

entry: 

exit: 

destroys: 

description: 



TTY 



entry: 

exit: 

destroys: 

description: 



03E7H 

(A) = character or character nuKia liitH 

[B] = command mode [0, 1 , ^1 
none 

all 

call here for the CHARACTER commands, as described in the manual; the com- 
mand mode bits select plot character-, set character mode, and define alternate 
characters; character mode bits are as described in the manual 

0B8EH 

[TX] = X coordinate 

[TY] = Y coordinate 

notie 

all 

call here to complement the bits on the tracking crross at [TX, TY], (i.e., if the 

cross is on at (TX, TY], turn it off, and vice versa] 

07A2H 

(HX] = X coordinate 

(HY] = Y coordinate 

none 

all 

call here to complement the bits on the crosshairs at (HX, HY] [i.e., if the 

crosshairs are on, turn them off, and vice versa] 

07D9H 

none 

none 

all 

call here to reset the alpha interface: (clears the screen and sets AX, AY to top 

left of screen] 

07EBH 

[A] = ASCII code 

none 

all 

call here to print an ASCII character at AX, AY (TTYCHAR does not advance AX, 

AY] 

G8EFH 

[A] = ASCII code 

none 

all 

call here to send an ASCII code to the ALPHA processor; control codes are 

recognized as described in the manual, and AX, AY are advanced, possibly invoking 

the scrolling mechanism 



flf 



Variables and Parameters: 



VARIABLE 


ADDR 


#BY1 


CX 


FFFB 


2. 


CY 


FFF9 


2 


NEWCX 


Fhb9 


2 


NEWCY 


hhb7 


2 


AX 


FFDO 


2 


AY 


FFCE 


2 


AR 


FFCD 


1 


AC 


FFCC 


1 


ALPHSCRL 


FFCB 


1 


ALPHMODE 


FFCA 


1 


CHARMODE 


FFC9 


1 


TX 


FFD4 


2 


TY 


FFD2 


2 


TSTAT 


FFD6 


1 


LPX 


FFFE 


1 


LPY 


FFFF 


1 


LPSTAT 


FFFD 


1 


HX 


FFBF 


2 


HY 


FFC1 


2 


HSTAT 


FFBE 


1 


ROMCHAR 


09FA 





#BYTES DESCRIPTION 



the current graphics X coordinate 

the current graphics Y coordinate 

[see the VECTOR entry point] 

(see the VECTOR entry point] 

the current ALPHA screen X coordinate 

the current ALPHA screen Y coordinate 

the current ALPHA row number 

the current ALPHA column number 

the current ALPHA scroll parameter 

the current ALPHA mode bits 

the current GRAPHICS character mode bits 

the current tracking cross X coordinate 

the current tracking cross Y coordinate 

1 if the tracking cross is visible, otherwise [ The DRAWCROSS 

entry point does not maintain this cell - you should do it manually 

when calling DRAWCROSS] 

the [X coordinate/2] of the last light pen interrupt 

the [Y coordinate/2] of the last light pen interrupt 

if no light pen interrupt has occurred, 1 otherwise [you should 
reset to to acknowledge a light pen interrupt] 

the current X coordinate of the crosshair 
the current Y coordinate of the crosshair 

1 if the crosshairs are visible, otherwise [the DRAWHAIRS entry 
point does not maintain this cell - you should do it manually when 
calling DRAWHAIRS 

the beginning of the ROM character generator 
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Appendix 4 

Screenware^"^ Pak II Internal Entry Points 

SYSTEM 0069H 

entry: none 
exit: none 
destroys: NA 
description: call here to restart the system as it would be at cold start 

READBUF 01 9EH 

entry: none 

exit: carry flag set if a byte is available, cleared otherwise: if carry set. [A] = byte from 
host 
destroys: A. D, E. H, L 
description: call here to read a byte from the host [via the interrupt buffered interface] if a 
byte is available 

GETBYTE 0059H 

entry: none 
exit: [A] = byte from host 
destroys: none 
description: call here to read a byte from the host; GETBYTE waits until a byte is available 

GETCGORD OODDH 

entry: none 

exit: [HL] = coordinate from host (sent high byte first] 
destroys: H. L 

description: call here to read a 9-bit coordinate from the host; the high 7 bits of H are zeroed 

GETYCORD G03BH 

entry: none 
exit: [HL] = 9-bit coordinate clipped to 479 

destroys: A 

description: call here to read a 9-bit coordinate from the host; the coordinate is clipped to 479 
if it is larger 

GETADDR 00G3H 

entry: none 

exit: [HL] = 1 6-bit address from host [sent high byte first] 

destroys: A 

description; call here to get a 1 B-bit quantity from the host 

SENDBYTE 034AH 

entry: [A] = byte 

exit: none 

destroys: B 

description: call here to send a byte to the host; SENDBYTE waits until the outbound buffer is 
clear before sending 

SENDCOORD 0345H 

entry: [HL] = 1 B-bit value to send to host 

exit: none 

destroys: B 

description: call here to send 1 6 bits [high order byte first] to the host 
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DPYLOC 



entry: 
exit: 



destroys: 
description: 



SCREENC 

entry: 

exit: 

destroys: 

description: 



POINT 



entry: 



exit: 

destroys: 

description: 



VECTOR 



entry: 



REGION 



exit: 

destroys: 

description: 



0306H 

[DE] rz X coordinate [0-511] 

[HL] = Y coordinate [0-479] 

[A] = bit mask 

[B] = bit mask 

[0] = bit number [0 leftmost, 7 rightmost] 
[HL] = display buffer address 
0, E 

call here to convert coordinates into a ZBO memory address [on the visible screen] 
and bit mask; the bit mask [containing one ON bit) identifies the pixel within the ad- 
dress byte; the bit number is the position of the ON bit within the byte 

0273H 

[A] = mode [0. 1 , 2,] 
none 

all 

call here for SCREEN command, as described in the manual; do not call with mode 

= 3, since this mode will try to read a byte from the host 

02DBH 

[B] = mode [0. 1 . 2] 
[DE] = X coordinate 
[HL] = Y coordinate 
[OX] = X coordinate 
[CY] = Y coordinate 
none 

all 

call here for POINT command, as described in the manual; do not call with mode 

= 3, since the code will then send a response to the host 

07B1H 

[B] = mode 

[DE] = X coordinate 

[NEWCX] = X coordinate 

[HL] = y coordinate 

[NEWCY] = y coordinate 



as described in the manual 



exit: 

destroys: 

description: 


none 

all 

call here for the VECTOR commands, 


N 

entry: 


049BH 

enter via the following code sequence: 




LXI H, RETURN 

PUSHH 

MVI B, < mode > 

PUSHB 



LXI H, < Y1 ) 

PUSHH 

LXI H, < X2 > 

PUSH H 

LXI D. < XI > 

LXI H, < Y2 ) 

JMP REGION 

RETURN: ... 

none 

all 

call via the given sequence for the REGION commands, as described in the manual 
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RPOINT 



entry: 



02D2H 

[B] = mode [0. 1 . 2] 



= X coordinate 
= Y coordinate 
= X coordinate 
= Y coordinate 



exit: 

destroys: 

description: 



RVECTOR 



entry: 



[DE] 

[HL] 

[CX] 

[CY] 

none 

all 

call here for RPOINT command, as described in the manual; do not call with mode 

= 3, since the code will then send a response to the host 

07A8H 

[B] = mode 

[DE] = X coordinate 

[NEWCX] = X coordinate 

[HL] = y coordinate 

[NEWCY] = y coordinate 



exit: 


none 


destroys: 


all 


description: 


call here for the RVECTOR commandi 


RREGION 


04g2H 


entry: 


enter via the following code sequence 




LXI H. RETURN 




PUSHH 




MVI B.[mode] 




PUSHB 




LXIH.[Y1] 




PUSHH 




LXIH.[X2] 




PUSHH 




LXID.[X1] 




LXI H.[Y2] 




JMP RREGION 




RETURN: ... 


exit: 


none 


destroys: 


all 


description: 


call via the given sequence for the RRI 



CHAR 



entry: 

exit: 

destroys: 

description: 



DRAWCROSS 

entry: 

exit: 

destroys: 

description: 



063EH 

[A] = character or character mode bits 

[B] = command mode [0, 1 , 2] 
none 

all 

call here for the CHARACTER commands, as described in the manual; the com- 
mand mode bits select plot character, set character mode, and define alternate 
characters; character mode bits are as described in the manual 

0E5DH 

[TX] = X coordinate 

[TY] = Y coordinate 

none 

all 

call here to complement the bits on the tracking crross at [TX, TY], [i.e., if the 

cross is on at [TX, TY], turn it off. and vice versa] 



no 



DRAWHAIRS 


11A4H 


entry: 


[HX] = X coordinate 




[HY] = Y coordinate 


exit: 


none 


destroys: 


all 


description: 


call here to connplement the bits on the crosshairs at [HX, HY] [i.e., if the 




crosshairs are on, turn them off, and vice versa] 


ALPHINIT 


0BA9H 


entry: 


none 


exit: 


none 


destroys: 


all 


description: 


call here to reset the alpha interface: [clears the screen and sets AX, AY to top 




left of screen] 


1 1 YCHAR 


08F7H 


entry: 


[A] = ASCII code 


exit: 


none 


destroys: 


all 


description: 


call here to print an ASCII character at AX, AY [II YCHAR does not advance AX, 




AY] 


1 lY 


0A71H 


entry: 


[A] = ASCII code 


exit: 


none 


destroys: 


all 


description: 


call here to send an ASCII code to the ALPHA processor; control codes are 



SPLO 



WTI 



entry: 

exit: 

destroys: 

description: 



entry: 

exit: 

destroys: 

description: 



FLD 



entry: 



exit: 

destroys: 

description: 



recognized as described in the manual, and AX, AY are advanced, possibly invoking 
the scrolling mechanism 

G203H 

[A] = number of ALPHA lines 

none 

all 

call here to split the screen into a graphic area and an alpha area 

05F7H 

none 

none 

all 

call here to force a cold start to the softv/are 

QC64H 

[A] = mode [0. 1 ) 

[DE] = X coordinate 

[HL] = Y coordinate 

enter via the following code sequence: 

PUSH PSW 

JMP FLD 

none 
all 
call here to flood the bordered region around point X,Y 



30 



CIR 

entry: 

exit: 

destroys; 

description: 

INVOKE 

entry: 

exit: 

destroys: 

description: 



0F41H 

[A] = radius 

[B] = mode [0.1.2] 
none 

all 

call here to draw a circle at current graphic cursor 

1041H 

[A] = macro # 

none 

all 

call here to invoke the desired previously created macro 
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Variables and Parameters: 



VARIABLE 


ADDR 


ttBf] 


CX 


FFFB 


2 


CY 


FFF9 


2 


NEWCX 


FFE9 


2 


NEWCY 


FFE7 


2 


AX 


FFDO 


2 


AY 


FFCE 


2 


AR 


FFCD 


1 


AC 


FFCC 


1 


ALPHSCRL 


FFCB 


1 


ALPHMODE 


FFCA 


1 


CHARMODE 


FFC9 


1 


TX 


hFU4 


2 


TY 


FFD2 


2 


TSTAT 


FFDB 


1 


LPX 


l-Fht 


1 


LPY 


FFFF 


1 


LPSTAT 


FFFD 


1 


HX 


FFBF 


2 


HY 


FFC1 


2 


HSTAT 


FFBE 


1 


ROMCHAR 


11DB 





#BV7ES DESCRIPTION 



the current graphics X coordinate 

the current graphics Y coordinate 

[see the VECTOR entry point] 

[see the VECTOR entry point] 

the current ALPHA screen X coordinate 

the current ALPHA screen Y coordinate 

the current ALPHA row number 

the current ALPHA column number 

the current ALPHA scroll parameter 

the current ALPHA mode bits 

the current GRAPHICS character mode bits 

the current tracking cross X coordinate 

the current tracking cross Y coordinate 

1 if the tracking cross is visible, otherwise [ The DRAWCROSS 

entry point does not maintain this cell - you should do it manually 

when calling DRAWCROSS] 

the [X coordinate/2] of the last light pen interrupt 

the [Y coordinate/2] of the last light pen interrupt 

if no light pen interrupt has occurred, 1 .otherwise [you should 
reset to to aknowledge a light pen interrupt] 

the current X coordinate of the crosshair 
the current Y coordinate of the crosshair 

1 if the crosshairs are visible, otherwise [the DRAWHAIRS entry 
point does not maintain this cell - you should do it manually when 
calling DRAWHAIRS 

the beginning of the ROM character generator 
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